Queries the data usage of each Internet service provider (ISP) and the number of visits in each region.
- You can query data that has been collected within the last seven days.
- The maximum number of times that each user can call this operation per second is 10.
- The data is collected at intervals of one minute.
- Before you can call this operation, submit a ticket to add the UID of your account to the whitelist.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeDomainRealTimeDetailData |
The operation that you want to perform. Set the value to DescribeDomainRealTimeDetailData. |
DomainName | String | Yes | example.com |
The accelerated domain name for which you want to query data. You can specify multiple accelerated domain names and separate them with commas (,). |
StartTime | String | Yes | 2019-11-30T05:33:00Z |
The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. Example: 2019-11-30T05:33:00Z. |
EndTime | String | Yes | 2019-11-30T05:40:00Z |
The end of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. Example: 2019-11-30T05:40:00Z. Note The end time must be later than the start time. The difference between the end time
and the start time cannot exceed 10 minutes.
|
Field | String | Yes | qps |
The type of data usage that you want to query. You can specify multiple data types and separate them with commas (,). Valid values:
|
LocationNameEn | String | No | Guangdong |
The name of the region. You can call the DescribeCdnRegionAndIsp operation to query regions. If you do not set this parameter, all regions are queried. |
IspNameEn | String | No | telecom |
The name of the Internet service provider. You can call the DescribeCdnRegionAndIsp operation to query ISPs. If you do not set this parameter, all ISPs are queried. |
Merge | String | No | false |
Specifies whether to merge the results. Valid values:
|
MergeLocIsp | String | No | false |
Specifies whether to merge the results. Valid values:
|
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
Data | String | "Data":{ "2019-11-30T05:40:00Z": { "example.com": { "Guangdong": { "telecom": { "qps": 10.0, "http_code": {"200": 1, "304": 2} } }, "Jiangsu": { "unicom": { "qps": 11.1, "http_code": {"200": 1, "304": 2, "403": 3} } } } } } |
The data usage of each ISP and the number of visits in each region. |
RequestId | String | B49E6DDA-F413-422B-B58E-2FA23F286726 |
The ID of the request. |
Examples
Sample requests
http(s)://cdn.aliyuncs.com? Action=DescribeDomainRealTimeDetailData
&DomainName=example.com
&StartTime=2019-11-30T05:33:00Z
&EndTime=2019-11-30T05:40:00Z
&Field=qps
&<Common request parameters>
Sample success responses
XML
format
<DescribeDomainRealTimeDetailDataResponse>
<Data>
<2018-06-05T20:00:00Z>
<example.com>
<Guangdong>
<telecom>
<qps>10</qps>
<http_code>
<200>1</200>
<304>2</304>
</http_code>
</telecom>
</Guangdong>
<Jiangsu>
<unicom>
<qps>11.1</qps>
<http_code>
<200>1</200>
<304>2</304>
<403>3</403>
</http_code>
</unicom>
</Jiangsu>
</example.com>
</2018-06-05T20:00:00Z>
</Data>
<RequestId>B49E6DDA-F413-422B-B58E-2FA23F286726</RequestId>
</DescribeDomainRealTimeDetailDataResponse>
JSON
format
{
"Data": {
"2018-06-05T20:00:00Z": {
"example.com": {
"Guangdong": {
"telecom": {
"qps": 10.0,
"http_code": {
"200": 1,
"304": 2
}
}
},
"Jiangsu": {
"unicom": {
"qps": 11.1,
"http_code": {
"200": 1,
"304": 2,
"403": 3
}
}
}
}
}
},
"RequestId": "B49E6DDA-F413-422B-B58E-2FA23F286726"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidTime.Malformed | Specified StartTime or EndTime is malformed. | The error message returned because the format of the specified start time or end time is invalid. |
For a list of error codes, visit the API Error Center.