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.
- 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
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.