Queries data statistics about accelerated domain names by Internet service provider (ISP). You can query the data that is collected over the last 90 days.

Note
  • You can call this operation up to 100 times per second.
  • If StartTime is set but EndTime is not set, the data within the hour that starts from StartTime is queried.
  • If EndTime is set but StartTime is not set, the data within the last hour that precedes EndTime is queried.
  • You can query data of a domain name or all domain names that belong to your account.
  • You can view data that is collected over the last seven days. The interval at which data is queried is based on the time range specified by StartTime and EndTime.
    • If the time range is shorter than or equal to one hour, data is queried every minute.
    • If the time range is longer than 1 hour but shorter than or equal to three days, data is queried every five minutes.
    • If the time range is longer than three days but shorter than or equal to seven days, data is queried every hour.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String No DescribeDcdnDomainIspData

The operation that you want to perform. Set the value to DescribeDcdnDomainIspData.

DomainName String No example.com

The accelerated domain name. You can specify only one domain name in each request.

If you do not specify an accelerated domain name, the data of all accelerated domain names that belong to your account is queried.

StartTime String No 2019-12-05T12:00:00Z

The beginning of the time range to query. Specify the time in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

EndTime String No 2019-12-06T12:00:00Z

The end of the time range to query. Specify the time in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

Note The end time must be later than the start time.

Response parameters

Parameter Type Example Description
DataInterval String 86400

The time interval between the data entries returned. Unit: seconds.

DomainName String example.com

The accelerated domain name.

EndTime String 2019-12-06T12:00:00Z

The end of the time range during which data was queried.

RequestId String 2E5AD83F-BD7B-462E-8319-2E30E305519A

The ID of the request.

StartTime String 2019-12-05T12:00:00Z

The beginning of the time range during which data was queried.

Value Array of IspProportionData

The access statistics by ISP.

IspProportionData
AvgObjectSize String 800019.0

The average response size. Unit: bytes.

AvgResponseRate String 154.3345765545624

The average response speed. Unit: byte/ms.

AvgResponseTime String 5183.666666666667

The average response time. Unit: milliseconds.

Bps String 380.9614285714286

The bandwidth.

BytesProportion String 0.003544181046236794

The proportion of network traffic. For example, a value of 90 indicates that 90% of network traffic was coming from the specified ISP.

Isp String China Unicom

The information about the ISP.

IspEname String unicom

The name of the ISP.

Proportion String 0.01155980271270037

The proportion of requests.

Qps String 5.9523809523809524E-5

The number of queries per second.

TotalBytes String 2400057

The total amount of network traffic.

TotalQuery String 3

The total number of requests.

Examples

Sample requests

http://dcdn.aliyuncs.com/?Action=DescribeDcdnDomainIspData
&DomainName=example.com
&StartTime=2019-12-05T12:00:00Z
&EndTime=2019-12-06T12:00:00Z
&<Common request parameters>

Sample success responses

XML format

<DescribeDcdnDomainIspDataResponse>
	  <Value>
		    <IspProportionData>
			      <Bps>380.9614285714286</Bps>
			      <Proportion>0.01155980271270037</Proportion>
			      <TotalBytes>2400057</TotalBytes>
			      <BytesProportion>0.003544181046236794</BytesProportion>
			      <TotalQuery>3</TotalQuery>
			      <IspEname>unicom</IspEname>
			      <Isp>China Unicom</Isp>
			      <AvgResponseRate>154.3345765545624</AvgResponseRate>
			      <AvgObjectSize>800019.0</AvgObjectSize>
			      <Qps>5.9523809523809524E-5</Qps>
			      <AvgResponseTime>5183.666666666667</AvgResponseTime>
		    </IspProportionData>
		    <IspProportionData>
			      <Bps>25110.431412698414</Bps>
			      <Proportion>0.31211467324291</Proportion>
			      <TotalBytes>158195717</TotalBytes>
			      <BytesProportion>0.23360872886644055</BytesProportion>
			      <TotalQuery>81</TotalQuery>
			      <IspEname>telecom</IspEname>
			      <Isp>China Telecom</Isp>
			      <AvgResponseRate>1397.1430909315718</AvgResponseRate>
			      <AvgObjectSize>1953033.5543209878</AvgObjectSize>
			      <Qps>0.0016071428571428571</Qps>
			      <AvgResponseTime>1397.8765432098764</AvgResponseTime>
		    </IspProportionData>
		    <IspProportionData>
			      <Bps>40343.86242857143</Bps>
			      <Proportion>0.33908754623921084</Proportion>
			      <TotalBytes>254166333</TotalBytes>
			      <BytesProportion>0.37532921137846464</BytesProportion>
			      <TotalQuery>88</TotalQuery>
			      <IspEname>mobile</IspEname>
			      <Isp>China Mobile</Isp>
			      <AvgResponseRate>787.8073097249128</AvgResponseRate>
			      <AvgObjectSize>2888253.7875</AvgObjectSize>
			      <Qps>0.001746031746031746</Qps>
			      <AvgResponseTime>3666.193181818182</AvgResponseTime>
		    </IspProportionData>
	  </Value>
	  <DataInterval>86400</DataInterval>
	  <RequestId>2E5AD83F-BD7B-462E-8319-2E30E305519A</RequestId>
	  <DomainName>example.com</DomainName>
	  <EndTime>2019-12-06T12:00:00Z</EndTime>
	  <StartTime>2019-12-05T12:00:00Z</StartTime>
</DescribeDcdnDomainIspDataResponse>

JSON format

{
  "Value": {
    "IspProportionData": [
      {
        "Bps": "380.9614285714286",
        "Proportion": "0.01155980271270037",
        "TotalBytes": "2400057",
        "BytesProportion": "0.003544181046236794",
        "TotalQuery": "3",
        "IspEname": "unicom",
        "Isp": "China Unicom",
        "AvgResponseRate": "154.3345765545624",
        "AvgObjectSize": "800019.0",
        "Qps": "5.9523809523809524E-5",
        "AvgResponseTime": "5183.666666666667"
      },
      {
        "Bps": "25110.431412698414",
        "Proportion": "0.31211467324291",
        "TotalBytes": "158195717",
        "BytesProportion": "0.23360872886644055",
        "TotalQuery": "81",
        "IspEname": "telecom",
        "Isp": "China Telecom",
        "AvgResponseRate": "1397.1430909315718",
        "AvgObjectSize": "1953033.5543209878",
        "Qps": "0.0016071428571428571",
        "AvgResponseTime": "1397.8765432098764"
      },
      {
        "Bps": "40343.86242857143",
        "Proportion": "0.33908754623921084",
        "TotalBytes": "254166333",
        "BytesProportion": "0.37532921137846464",
        "TotalQuery": "88",
        "IspEname": "mobile",
        "Isp": "China Mobile",
        "AvgResponseRate": "787.8073097249128",
        "AvgObjectSize": "2888253.7875",
        "Qps": "0.001746031746031746",
        "AvgResponseTime": "3666.193181818182"
      }
    ]
  },
  "DataInterval": "86400",
  "RequestId": "2E5AD83F-BD7B-462E-8319-2E30E305519A",
  "DomainName": "example.com",
  "EndTime": "2019-12-06T12:00:00Z",
  "StartTime": "2019-12-05T12:00:00Z"
}

Error codes

HttpCode Error code Error message Description
400 MissingTimeParameter The StartTime and EndTime must be both specified. The error message returned because no values are specified for the StartTime and EndTime parameters.
400 InvalidEndTime.Malformed The specified EndTime is invalid. The error message returned because the format of the EndTime parameter is invalid. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
400 InvalidEndTime.Mismatch The specified EndTime is earlier than the StartTime. The error message returned because the end time is earlier than the start time.
400 InvalidStartTime.ValueNotSupported The specified StartTime is invalid. The error message returned because the value specified for the StartTime parameter is invalid. Specify a valid value.
404 InvalidDomain.NotFound The specified domain does not exist. The error message returned because the specified domain name does not exist.

For a list of error codes, visit the API Error Center.