Queries the bandwidth values by Internet service provider (ISP) and region.
Operation description
- The data is collected every 5 minutes.
- You can call this operation up to 20 times per second per account.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
DomainNames | string | Yes | The accelerated domain name. | example.com |
StartTime | string | Yes | 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. | 2019-11-30T05:33:00Z |
EndTime | string | Yes | 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. Note
The end time must be later than the start time. The maximum time range that can be specified is 1 hour.
| 2019-11-30T05:40:00Z |
IspNames | string | No | The name of the ISP. You can specify only one ISP name in each call. You can call the DescribeCdnRegionAndIsp operation to query ISPs. | unicom |
LocationNames | string | No | The names of the regions. Separate multiple region names with commas (,). You can call the DescribeCdnRegionAndIsp operation to query the most recent region list. | liaoning,guangxi |
Response parameters
Examples
Sample success responses
JSON
format
{
"JsonResult": "{\"1472659200\":{\"Tianjin\":{\"China Telecom\":{\"http_codes\":{\"000\":0,\"200\":6,\"400\":0},\"rt\":4183,\"bandwidth\":46639,\"avg_speed\":7773,\"pv\":6,\"hit_rate\":0.93,\"request_hit_rate\":0.66}}}}\n",
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | The specified start time is invalid. For more information, see the API references. |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | The format of the end time is invalid. Specify a valid value. |
400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | The start time is invalid. Set this parameter to another value and try again. |
400 | InvalidTime.ValueNotSupported | StartTime or EndTime is miss match. | Start time and end time do not match, time span limit is exceeded, or the time parameter is invalid. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2023-06-13 | The Error code has changed | View Change Details |