Queries the bandwidth values at a specific time based on an Internet service provider (ISP) in different regions for an accelerated domain name.
Debugging
Request parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| Action | String | Yes | DescribeRangeDataByLocateAndIspService | The operation that you want to perform. Set the value to DescribeRangeDataByLocateAndIspService. |
| DomainNames | String | Yes | example.com | The accelerated domain name. |
| 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.
Note The end time must be later than the start time. The difference between the end time and the start time cannot exceed 1 hour.
|
| 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. |
| IspNames | String | No | unicom | The name of the ISP. You can specify only one ISP name in each call. You can call the DescribeCdnRegionAndIsp operation to query ISPs. |
| LocationNames | String | No | liaoning,guangxi | The names of the regions. Separate regions with commas (,). You can call the DescribeCdnRegionAndIsp operation to query the most recent region list. |
Response parameters
| Parameter | Type | Example | Description |
|---|---|---|---|
| JsonResult | String | {"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}}}} | The response parameters in JSON format. These parameters indicate the following information in sequence: UNIX time, region, ISP, distribution of HTTP status codes, response time, bandwidth (bit/s), average response rate, page views, cache hit ratio, and request hit ratio. |
| RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 | The ID of the request. |
Examples
Sample requests
http://cdn.aliyuncs.com/?Action=DescribeRangeDataByLocateAndIspService
&DomainNames=example.com
&LocationNames=liaoning,guangxi
&IspNames=unicom
&startTime=2019-11-30T05:33:00Z
&EndTime=2019-11-30T05:40:00Z
&<Common request parameters>Sample success responses
XML format
<DescribeRangeDataByLocateAndIspServiceResponse>
<JsonResult>
<1472659200>
<Tianjin>
<China Telecom>
<bandwidth>9889849.592</bandwidth>
<pv>5739</pv>
<hit_rate>0</hit_rate>
<http_codes>
<200>5675</200>
<206>5</206>
<302>5</302>
<304>45</304>
<400>1</400>
<403>8</403>
<404>0</404>
<405>0</405>
<408>0</408>
<412>0</412>
<416>0</416>
<500>0</500>
<501>0</501>
<502>0</502>
<503>0</503>
<504>0</504>
<000>0</000>
</http_codes>
<rt>0</rt>
</China Telecom>
<China Unicom/>
<China Mobile/>
</Tianjin>
<Beijing>
<China Telecom>
<bandwidth>9889849.592</bandwidth>
<pv>5739</pv>
<hit_rate>0</hit_rate>
<http_codes>
<200>5675</200>
<206>5</206>
<302>5</302>
<304>45</304>
<400>1</400>
<403>8</403>
<404>0</404>
<405>0</405>
<408>0</408>
<412>0</412>
<416>0</416>
<500>0</500>
<501>0</501>
<502>0</502>
<503>0</503>
<504>0</504>
<000>0</000>
</http_codes>
<rt>0</rt>
</China Telecom>
<China Unicom/>
<China Mobile/>
</Beijing>
</1472659200>
<1472659500>
<Tianjin>
<China Telecom>
<bandwidth>7024681.44</bandwidth>
<pv>5819</pv>
<hit_rate>0</hit_rate>
<http_codes>
<200>5716</200>
<206>11</206>
<302>3</302>
<304>72</304>
<400>1</400>
<403>16</403>
<404>0</404>
<405>0</405>
<408>0</408>
<412>0</412>
<416>0</416>
<500>0</500>
<501>0</501>
<502>0</502>
<503>0</503>
<504>0</504>
<000>0</000>
</http_codes>
<rt>0</rt>
</China Telecom>
<China Unicom/>
<China Mobile/>
</Tianjin>
</1472659500>
</JsonResult>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</DescribeRangeDataByLocateAndIspServiceResponse>JSON format
{
"JsonResult":[{
"1472659200": {
"Tianjin": { {
"China Telecom" {
"bandwidth": 9889849.592,
"pv": 5739,
"hit_rate": 0,
"http_codes": {
"200": 5675,
"206": 5,
"302": 5,
"304": 45,
"400": 1,
"403": 8,
"404": 0,
"405": 0,
"408": 0,
"412": 0,
"416": 0,
"500": 0,
"501": 0,
"502": 0,
"503": 0,
"504": 0,
"000": 0
},
"rt": 0
},
"China Unicom": {},
"China Mobile": {}
},
"Beijing": { {
"China Telecom" {
"bandwidth": 9889849.592,
"pv": 5739,
"hit_rate": 0,
"http_codes": {
"200": 5675,
"206": 5,
"302": 5,
"304": 45,
"400": 1,
"403": 8,
"404": 0,
"405": 0,
"408": 0,
"412": 0,
"416": 0,
"500": 0,
"501": 0,
"502": 0,
"503": 0,
"504": 0,
"000": 0
},
"rt": 0
},
"China Unicom": {},
"China Mobile": {}
}
},
"1472659500": {
"Tianjin": { {
"China Telecom" {
"bandwidth": 7024681.44,
"pv": 5819,
"hit_rate": 0,
"http_codes": {
"200": 5716,
"206": 11,
"302": 3,
"304": 72,
"400": 1,
"403": 16,
"404": 0,
"405": 0,
"408": 0,
"412": 0,
"416": 0,
"500": 0,
"501": 0,
"502": 0,
"503": 0,
"504": 0,
"000": 0
},
"rt": 0
},
"China Telecom" {},
"China Mobile": {}
}
}
}],
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}Error codes
| HttpCode | Error code | Error message | Description |
|---|---|---|---|
| 400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | The error message returned because the format of the specified start time is invalid. For more information about the time format, see the Request parameters section. |
| 400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | The error message returned because the format of the specified end time is invalid. For more information about the time format, see the Request parameters section. |
| 400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | The error message returned because the specified start time is invalid. Rectify the start time and try again. |
For a list of error codes, visit the API Error Center.