You can call the DescribeRangeDataByLocateAndIspService operation to query the bandwidth data of a CDN domain name in different regions for Internet Service Providers (ISPs) at a specific time. The bandwidth is measured in bit/second.

Note
  • You can specify only one domain name at a time.
  • The data sampling interval is set to five minutes.

Debugging

Alibaba Cloud provides OpenAPI Explorer to simplify API usage. You can use OpenAPI Explorer to search for APIs, call APIs, and dynamically generate SDK example code.

Request parameters

Parameter Type Required Description
Action String  Yes The operation that you want to perform. Set this parameter to DescribeRangeDataByLocateAndIspService.
DomainNames String Yes The domain name that you want to query. This parameter cannot be left empty.
LocationNames String No
  • The list of regions that you want to query. Separate multiple regions with commas (,). This parameter cannot be left empty.
  • You can call the DescribeCdnRegionAndIsp operation to query the region names.
IspNames String No
  • The list of ISPs that you want to query. Separate multiple ISPs with commas (,). This parameter cannot be left empty.
  • You can call the DescribeCdnRegionAndIsp operation to query the ISP names.
StartTime String Yes The beginning of the time range where the data is queried.
  • Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format.
  • The time must be in UTC.
  • The minimum time granularity is five minutes.
EndTime String Yes The end of the time range where the data is queried.
  • Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format.
  • The time must be in UTC.

Response parameters

Parameter Type Description
LocationAndISPInfoList LocationAndISPInfo The network monitoring data based on ISPs in different regions.

LocationAndISPInfo

Parameter Type Discription
LocationAndISPJson String The JSON string.

Examples

Sample request

http://cdn.aliyuncs.com?Action=DescribeRangeDataByLocateAndIspService&DomainNames=example.com
&LocationNames=liaoning,guangxi
&IspNames=unicom,telecom
&StartTime=2016-08-01T22:00:00Z
&EndTime=2016-08-02T22:00:00Z
&<Common request parameters>

Sample success response

JSON format

{
        "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 Unicom":{},
                "China Mobile":{}
            }
        }
    }, 
    "description": "Ok", 
    "retCode": 0
}

Error codes

Error code Error message HTTP status code Description
InvalidDomainNames.Malformed Specified domainNames is malformed. 400 The error message returned because the specified domain name is invalid.
InvalidStartTime.Malformed Specified StartTime is malformed. 400 The error message returned because the format of the StartTime parameter is invalid.
InvalidEndTime.Malformed Specified EndTime is malformed. 400 The error message returned because the format of the EndTime parameter is invalid.
InvalidTime.ValueNotSupported StartTime or EndTime is miss match. 400 The error message returned because the EndTime is earlier than the StartTime.
LossParams DomainNames, StartTime and EndTime should not be empty or domainName have been registered. 400 The error message returned because the required parameters are not set.
InvalidParams Your parameters is invalid. 400 The error message returned because the parameters are invalid.