All Products
Search
Document Center

DescribeDcdnDomainOriginBpsData

Last Updated: Mar 01, 2019

Description

You can call this operation to obtain the bandwidth based on back-to-origin events for domain names. The bandwidth is measured in bits/s.

If you specify neither StartTime nor EndTime, you obtain the data for the last 24 hours by default. You can also specify both StartTime and EndTime to obtain the data for a specified period.

  • You can perform a batch query for domain names. The domain names must be separated with half-width commas (,).

  • You can only obtain the data for the last 90 days.

Request parameters

Name Type Required Description
Action String Yes The operation that you want to perform.
Set the value to DescribeDcdnDomainOriginBpsData.
DomainName String No The domain name. If you do not specify this parameter, you obtain the data of all your domain names by default.
You can specify the domain name that you want to query.
You can also perform a batch query for domain names. The domain names must be separated with half-width commas (,).
StartTime String No The start time of the queried data. The date format follows the ISO8601 standard and UTC time is used.
The format is YYYY-MM-DDThh:mm:ssZ.
The minimum granularity is 5 minutes.
If you do not specify this parameter, you obtain the data for the last 24 hours by default.
EndTime String No The end time of the queried data. The end time must be later than the start time.
The date format follows the ISO8601 standard and UTC time is used.
The format is YYYY-MM-DDThh:mm:ssZ.
Interval String No The interval of the queried data. Unit: second. Valid values:
  • Less than 3 days: 300, 3600, and 86400.
  • 3–31 days (excluding 31 days): 3600 and 86400.
  • No less than 31 days: 86400.
  • The default value if you do not specify the parameter or if you specify an invalid value.

Response parameters

Name Type Description
DomainName String The domain name.
DataInterval String The interval between records. Unit: second.
StartTime DateTime The start time of the queried data.
EndTime DateTime The end time of the queried data.
OriginBpsDataPerInterval DataModule[] The bandwidth data based on back-to-origin events at each interval.

DataModule

Name Type Description
TimeStamp String The start time of the specified time slice.
OriginBps Float The bandwidth data based on back-to-origin events.
DynamicHttpOriginBps Float The bandwidth used for fetching dynamic content from the origin over HTTP.
DynamicHttpsOriginBps Float The bandwidth used for fetching dynamic content from the origin over HTTPS.
StaticHttpOriginBps Float The bandwidth used for fetching static content from the origin over HTTP.
StaticHttpsOriginBps Float The bandwidth used for fetching static content from the origin over HTTPS.

Examples

Sample requests

  1. http://dcdn.aliyuncs.com?Action=DescribeDcdnDomainOriginBpsData&DomainName=test.com
  2. &StartTime=2017-12-10T20:00:00Z
  3. &EndTime=2017-12-10T21:00:00Z
  4. &<Common request parameters>

Sample responses

JSON format

  1. {
  2. "DomainName": "test.com",
  3. "DataInterval": "300",
  4. "SrcBpsDataPerInterval": {
  5. "DataModule": [
  6. {
  7. "TimeStamp": "2017-12-10T21:00:00Z",
  8. "OriginBps": 200",
  9. "DynamicHttpOriginBps": 100,
  10. "DynamicHttpsOriginBps": 100,
  11. "StaticHttpOriginBps": 0,
  12. "StaticHttpsOriginBps": 0,
  13. }
  14. ]
  15. },
  16. "RequestId": "7CBCD6AD-B016-42E5-AE0B-B3731DE8F755",
  17. "StartTime": "2017-12-10T20:00:00Z",
  18. "EndTime": "2017-12-10T21:00:00Z"
  19. }

Error codes

Error code Description HTTP status code Description
Throttling Request was denied due to request throttling. 503 The error message returned when the request is denied due to throttling.
InvalidDomain.NotFound The domain provided does not belong to you. 404 The error message returned when the domain name does not exist or does not belong to you.