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

Note
  • You can specify only one domain name at a time.
  • The minimum time granularity is 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 DescribeDomainBpsDataByTimeStamp.
DomainName String Yes The domain names that you want to query. You cannot leave this parameter empty.
LocationNames String Yes
  • The regions that you want to query. Separate multiple regions with commas (,). You cannot leave this parameter empty.
  • You can call the DescribeCdnRegionAndIsp operation to query the names of regions.
IspNames String Yes
  • The ISPs that you want to query. Separate multiple ISPs with commas (,). You cannot leave this parameter empty.
  • You can call the DescribeCdnRegionAndIsp operation to query the names of the ISPs.
TimePoint 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.

Response parameters

Parameter Type Description
DomainName String The domain name information.
TimePoint String  The time when the data was queried.
BpsDataList BpsDataModel[] The bandwidth data of the specified regions and ISPs. The bandwidth is measured in bit/second.

BpsDataModel

Parameter Type Discription
LocationName String  The name of the region.
IspName String  The name of the ISP.
Bps Long The bandwidth.

Examples

Sample request

http://cdn.aliyuncs.com?Action=DescribeDomainBpsDataByTimeStamp&DomainName=example.com
&LocationNames=liaoning,guangxi
&IspNames=unicom,telecom
&TimePoint=2016-08-01T22:00:00Z
&<Common request parameters>

Sample success response

JSON format

{
    "TimeStamp": "2016-08-01T22:00:00Z", 
    "BpsDataList": {
        "BpsDataModel": [
            {
                "LocationName": "Liaoning", 
                "Bps": 880996111, 
                "IspName": "telecom"
            }, 
            {
                "LocationName": "Liaoning", 
                "Bps": 52119553, 
                "IspName": "unicom"
            }, 
            {
                "LocationName": "Guangxi", 
                "Bps": 51295137, 
                "IspName": "telecom"
            }, 
            {
                "LocationName": "Guangxi", 
                "Bps": 18673571, 
                "IspName": "unicom"
            }
        ]
    }, 
    "RequestId": "7682DE14-3B4D-48D0-9B7C-DD3C8C3E1C78", 
    "DomainName": "example.cn"
}

Error codes

Error code Error message HTTP status code Description
Throttling Request was denied due to request throttling. 503 The error message returned because the request is denied due to network traffic throttling.
IllegalOperation Illegal domain, operation is not permitted. 403 The error message returned because the domain name is invalid.
OperationDenied Your account does not open CDN service yet. 403 The error message returned because the CDN service is not activated.
OperationDenied Your CDN service is suspended. 403 The error message returned because the CDN service is suspended.
InvalidDomain.NotFound The domain provided does not belong to you. 404 The error message returned because the domain name does not exist or does not belong to you.
InvalidDomain.Offline The domain provided is offline. 404 The error message returned because the domain name is disabled.
ServiceBusy The specified Domain is configuring, please retry later. 403 The error message returned because the domain name is being configured. Please try again later.
InvalidTimePoint.Malformed Specified TimePoint malformed. 400 The error message returned because the format of the TimePoint parameter is invalid.
InvaildParameter IspNames Not Supported 400 The error message returned because the specified ISP is invalid.
InvaildParameter LocationNames Not Supported 400 The error message returned because the specified region is invalid.