Queries the proportions of the data usage of the requests that were initiated through different Internet service providers (ISPs) for one or more accelerated domains. The data is collected on a daily basis. You can query the data in the last 90 days.
- If you specify neither StartTime nor EndTime, data in the last 24 hours is returned. If you specify both StartTime and EndTime, data in the specified time range is returned.
- You can query the data of one accelerated domain or all accelerated domains under your account.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeDcdnDomainIspData |
The operation that you want to perform. Set the value to DescribeDcdnDomainIspData. |
DomainName | String | No | example.com |
The name of the accelerated domain for which you want to query the data. You can specify only one domain name. If you do not specify an accelerated domain name, all accelerated domains under your account are 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. 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. Unit: second. |
DomainName | String | example.com |
The name of the accelerated domain for which the data was returned. |
EndTime | String | 2019-12-06T12:00:00Z |
The end of the time range where the 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 where the data was queried. |
Value | Array |
The proportions of the data usage of the requests that were initiated through each ISP. |
|
IspProportionData | |||
AvgObjectSize | String | 800019.0 |
The average size of returned content. Unit: byte. |
AvgResponseRate | String | 154.3345765545624 |
The average response speed. Unit: byte/ms. |
AvgResponseTime | String | 5183.666666666667 |
The average response time. Unit: ms. |
Bps | String | 380.9614285714286 |
The bandwidth data. |
BytesProportion | String | 0.003544181046236794 |
The proportion of network traffic transmitted through the specified ISP to the total amount of network traffic in percentile. For example, a value of 90 indicates that 90% of the total network traffic is transmitted through 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 the requests initiated through the ISP. |
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 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 both the StartTime and EndTime parameters must be specified. |
400 | InvalidEndTime.Malformed | The specified EndTime is invalid. | The error message returned because the specified end time 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 specified end time is earlier than the specified start time. |
400 | InvalidStartTime.ValueNotSupported | The specified StartTime is invalid. | The error message returned because the specified start time is invalid. |
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.