All Products
Search
Document Center

DescribeDcdnDomainOriginTrafficData

Last Updated: May 17, 2019

Description

You can call this operation to obtain back-to-origin traffic of a specified DCDN domain name. Unit: bits.

If you do not specify the StartTime and EndTime, you obtain back-to-origin traffic of the last 24 hours by default. To obtain the back-to-origin traffic within a certain period, you must specify both the StartTime and the EndTime.

  • You can specify multiple domain names separated with commas (,).

  • You can obtain the back-to-origin traffic of the last 90 days at most.

Request parameters

Name Type Required Description
Action String Yes The operation that you want to perform.
Set the value to DescribeDcdnDomainOriginTrafficData.
DomainName String No If you do not specify the parameter, you obtain the merged back-to-origin traffic data of all DCDN domain names by default.
You can enter the DCDN domain name that you want to query.
You can also specify multiple domain names separated with commas (,).
StartTime String No The start time of the required data. The date format follows the ISO8601 standard and uses UTC time.
Format: YYYY-MM-DDThh:mm:ssZ.
The minimum interval between the start time and the end time of the required data is 5 minutes.
If you do not specify the StartTime, you obtain the back-to-origin traffic of the last 24 hours by default.
EndTime String No The end time of the required data. The date format follows the ISO8601 standard and uses UTC time.
The end time must be later than the start time.
Format: YYYY-MM-DDThh:mm:ssZ.
Interval String No The interval between the start time and the end time of the required data. Unit: seconds. Valid values:
  • Less than 3 days: 300, 3600, and 86400.
  • 3 days-31 days (excluding 31 days): 3600 and 86400.
  • No less than 31 days: 86400.
  • The default value is used if you do not specify the parameter or specify an invalid value.

Response parameters

Name Type Description
DomainName String The name of the specified DCDN domain.
DataInterval String The interval of each item. Unit: seconds.
StartTime DateTime The start time of the required data.
EndTime DateTime The end time of the required data.
OriginTrafficDataPerInterval DataModule[] The back-to-origin traffic at the specified intervals.

DataModule

Name Type Description
TimeStamp String The start time of the specified time slice.
OriginTraffic Float The value of back-to-origin traffic.
DynamicHttpOriginTraffic Float The value of dynamic HTTP back-to-origin traffic.
DynamicHttpsOriginTraffic Float The value of dynamic HTTPS back-to-origin traffic.
StaticHttpOriginTraffic Float The value of static HTTP back-to-origin traffic.
StaticHttpsOriginTraffic Float The value of static HTTPS back-to-origin traffic.

Examples

Sample requests

  1. http://dcdn.aliyuncs.com?Action=DescribeDcdnDomainOriginTrafficData&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. "OriginTrafficDataPerInterval": {
  5. "DataModule": [
  6. {
  7. "TimeStamp": "2017-12-10T21:00:00Z",
  8. "OriginTraffic": 1000,
  9. "DynamicHttpOriginTraffic": 500,
  10. "DynamicHttpsOriginTraffic": 500,
  11. "StaticHttpOriginTraffic": 0,
  12. "StaticHttpsOriginTraffic": 0
  13. }
  14. ]
  15. },
  16. "RequestId": "A666D44F-19D6-490E-97CF-1A64AB962C57",
  17. "StartTime": "2017-12-10T20:00:00Z",
  18. "EndTime": "2017-12-10T21:00:00Z"
  19. }

Error codes

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