Queries the 95th percentile bandwidth values of one or more accelerated domain names.

Note
  • The bandwidth is measured in bit/s.
  • If you do not set the StartTime or EndTime parameter, data collected within the last 24 hours is queried. If you set both the StartTime and EndTime parameters, data collected within the specified time range is queried.
  • You can specify multiple domain names and separate them with commas (,).
  • You can query data collected within the last 90 days.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeDomainMax95BpsData

The operation that you want to perform. Set the value to DescribeDomainMax95BpsData.

DomainName String No www.yourdomain.com

The name of the accelerated domain for which you want to query data. You can specify one or more domain names and separate them with commas (,).

If you do not specify this parameter, the data of all accelerated domains is returned.

StartTime String No 2017-12-21T08:00:00: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.
  • Data is collected every 5 minutes. If you do not set this parameter, data within the last 24 hours is queried.
EndTime String No 2017-12-22T08:00:00:00Z

The end of the time range to query.

  • The end of the time range to query. The end time must be later than the start time.
  • Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format.
  • The time must be in UTC.
TimePoint String No 2017-12-22T08:00:00: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.

Cycle String No day

The statistical period for collecting 95th percentile bandwidth values. Valid values: day and month.

Response parameters

Parameter Type Example Description
DomainName String example.com

The information about the accelerated domain name.

StartTime String 2015-12-10T20:00Z

The start of the time range that was queried.

EndTime String 2015-12-10T21:00Z

The end of the time range that was queried.

Max95Bps String 16777590.28

The 95th percentile bandwidth values.

DomesticMax95Bps String 16777590.28

The 95th percentile bandwidth values in mainland China.

OverseasMax95Bps String 0

The 95th percentile bandwidth values outside mainland China.

RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

The ID of the request.

Examples

Sample requests

http://cdn.aliyuncs.com/?Action=DescribeDomainMax95BpsData
&DomainName=example.com
&StartTime=2015-12-10T20:00Z
&EndTime=2015-12-10T21:00Z
&<Common request parameters>

Sample success responses

XML format

<DescribeDomainMax95BpsDataResponse>
      <DomainName>example.com</DomainName>
      <RequestId>3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F</RequestId>
      <StartTime>2015-12-10T20:00Z</StartTime>
      <EndTime>2015-12-10T21:00Z</EndTime>
      <Max95Bps>16777590.28</Max95Bps>
      <DomesticMax95Bps>16777590.28</DomesticMax95Bps>
      <OverseasMax95Bps>0</OverseasMax95Bps>
</DescribeDomainMax95BpsDataResponse>

JSON format

{
    "DomainName": "example.com",
    "RequestId": "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
    "StartTime": "2015-12-10T20:00Z",
    "EndTime": "2015-12-10T21:00Z",
    "Max95Bps": "16777590.28",
    "DomesticMax95Bps": "16777590.28",
    "OverseasMax95Bps": "0"

}

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.
404 InvalidDomain.NotFound The domain provided does not exist in our records. The error message returned because the specified domain name does not exist or does not belong to the current Alibaba Cloud account. Check whether the domain name is correctly specified, whether the domain name belongs to the current Alibaba Cloud account, and whether the domain name is expired.

For a list of error codes, visit the API Error Center.