You can call the DescribeDomainRealTimeBpsData operation to query the bandwidth data with a time granularity of one minute.

Note
  • You can query the data within the last seven days. For each query, the time range specified by the StartTime and EndTime parameters cannot exceed 24 hours.
  • If neither the StartTime nor EndTime parameter is set, the data within the last one hour is queried.

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 DescribeDomainRealTimeBpsData.
DomainName String Yes The domain name.
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.
  • Example: 2016-10-20T04:00:00Z.
  • If you do not set this parameter, the data within the hour before the EndTime is queried.
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.
  • Example: 2016-10-20T04:00:00Z.
  • If you do not set this parameter, the data within the hour after the StartTime is queried.
IspNameEn String  Yes The English name of the Internet service provider (ISP). If you do not specify an ISP, all ISPs are queried. You can call the DescribeCdnRegionAndIsp operation to query the names of ISPs.
LocationNameEn String Yes The English name of the region. If you do not specify a region, all regions are queried. You can call the DescribeCdnRegionAndIsp operation to query the region names.

Response parameters

Parameter Type Description
RequestId String The ID of the request.
TimeStamp String The timestamp of the data.
  • The time follows the ISO 8601 standard in the yyyy-MM-ddThh:mmZ format. The time is displayed in UTC.
  • Example: 2016-10-20T04:00:00Z.
Bps Float The bandwidth. Unit: bit/s.

Examples

Sample request

https://cdn.aliyuncs.com/?Action=DescribeDomainRealTimeBpsData&DomainName=example.com&EndTime=2018-01-02T11%3A05%3A37Z&IspNameEn=telecom&LocationNameEn=beijing<Common request parameters>

Sample response

{
   "Data":{
      "BpsModel":[
         {
            "TimeStamp":"2018-01-02T11:05:00Z",
            "Bps":16710625.733333332
         },
         {
            "TimeStamp":"2018-01-02T11:04:00Z",
            "Bps":59392614.8
         }
      ]
   },
   "RequestId":"B49E6DDA-F413-422B-B58E-2FA23F286726"
}

Error codes

Error code Error message HTTP status code Description
InvalidTime.Malformed Specified time is malformed. 400 The error message returned because the format of the time parameters is invalid.
InvalidDomainName.Malformed Specified DomainName is malformed. 400 The error message returned because the domain name is not specified or the specified domain name does not exist.