All Products
Search
Document Center

DescribeDcdnDomainHttpCodeData

Last Updated: Mar 01, 2019

Description

You can call this operation to obtain the proportion of each HTTP status code at a sampling interval of 5 minutes.

By default, you can obtain data for the last 24 hours.

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

  • You can obtain data for the last 90 days at most by specifying the StartTime and EndTime parameters.

Request parameters

Name Type Required Description
Action String Yes The operation that you want to perform.
Set the value to DescribeDcdnDomainHttpCodeData.
DomainName String Yes The DCDN domain name.
You can specify multiple domain names separated by commas (,).
StartTime String No The start time of the data sampling.
The time must be in UTC and the date must follow the ISO8601 format.
Format: YYYY-MM-DDThh:mm:ssZ.
The minimum sampling interval is 5 minutes.
If this is left blank, you will obtain data for the last 24 hours.
EndTime String No The end time of the data sampling, which must be later than the start time.
The time must be in UTC and the date must follow the ISO8601 format.
Format: YYYY-MM-DDThh:mm:ssZ.
Interval String No The sampling interval. Supports 300, 3600, and 86400 seconds.
If you obtain data for less than 3 days, a sampling interval of 300, 3600, and 86400 seconds is supported.
If you obtain data for 3-30 days, a sampling interval of 3600 and 86400 seconds is supported.
If you obtain data for 31-90 days, a sampling interval of 86400 seconds is supported.
If the parameter is left blank or the value you specified is invalid, the default sampling interval is applied.
LocationNameEn String No The name of the region.
You can call the DescribeCdnRegionAndIsp operation to obtain the region. If the parameter is left blank, you will obtain data for all regions.
IspNameEn String No The name of the Internet service provider (ISP).
You can call the DescribeCdnRegionAndIsp operation to obtain the ISP. If the parameter is left blank, you will obtain data of all the ISPs.

Response parameters

Name Type Description
RequestId String The ID of the request.
DomainName String The DCDN domain name.
DataInterval String The sampling interval, measured in seconds. The interval is always set to 300 seconds.
StartTime DateTime The start time of the data sampling.
EndTime DateTime The end time of the data sampling.
DataPerInterval DataModule[] The proportion of each HTTP status code for each sampling interval.

DataModule

Name Type Description
TimeStamp String The start time of the sampling interval.
HttpCodeDataPerInterval HttpCodeDataModule[] The list of the proportions of HTTP status codes.

HttpCodeDataModule

Name Type Description
Code Integer The HTTP status code.
Proportion Long The proportion of the HTTP status code.
Count Long The total number of HTTP status codes.

Examples

Sample requests

  1. http://scdn.aliyuncs.com?Action=DescribeDcdnDomainHttpCodeData&DomainName="test.com,abc.com"
  2. &StartTime=2018-03-01T05:00:00Z
  3. &EndTime=2018-03-01T13:00:00Z
  4. &<Common request parameters>

Sample responses

JSON format

  1. {
  2. "DataInterval": 3600,
  3. "RequestId": "91FC2D9D-B042-4634-8A5C-7B8E7482C22D",
  4. "EndTime": "2018-03-01T13:00:00Z",
  5. "StartTime": "2018-03-01T05:00:00Z",
  6. "HttpCodeDataPerInterval": {
  7. "DataModule": [
  8. {
  9. "TimeStamp": "2018-03-01T13:00:00Z",
  10. "HttpCode": {
  11. "HttpCodeDataModule": []
  12. }
  13. },
  14. {
  15. "TimeStamp": "2018-03-01T12:00:00Z",
  16. "HttpCode": {
  17. "HttpCodeDataModule": [
  18. {
  19. "Count": 16,
  20. "Proportion": 100,
  21. "Code": 404
  22. }
  23. ]
  24. }
  25. },
  26. {
  27. "TimeStamp": "2018-03-01T11:00:00Z",
  28. "HttpCode": {
  29. "HttpCodeDataModule": [
  30. {
  31. "Count": 9,
  32. "Proportion": 50,
  33. "Code": 403
  34. },
  35. {
  36. "Count": 9,
  37. "Proportion": 50,
  38. "Code": 504
  39. }
  40. ]
  41. }
  42. },
  43. {
  44. "TimeStamp": "2018-03-01T10:00:00Z",
  45. "HttpCode": {
  46. "HttpCodeDataModule": []
  47. }
  48. },
  49. {
  50. "TimeStamp": "2018-03-01T09:00:00Z",
  51. "HttpCode": {
  52. "HttpCodeDataModule": []
  53. }
  54. },
  55. {
  56. "TimeStamp": "2018-03-01T08:00:00Z",
  57. "HttpCode": {
  58. "HttpCodeDataModule": []
  59. }
  60. },
  61. {
  62. "TimeStamp": "2018-03-01T07:00:00Z",
  63. "HttpCode": {
  64. "HttpCodeDataModule": [
  65. {
  66. "Count": 1,
  67. "Proportion": 50,
  68. "Code": 503
  69. },
  70. {
  71. "Count": 1,
  72. "Proportion": 50,
  73. "Code": 403
  74. }
  75. ]
  76. }
  77. },
  78. {
  79. "TimeStamp": "2018-03-01T06:00:00Z",
  80. "HttpCode": {
  81. "HttpCodeDataModule": [
  82. {
  83. "Count": 1,
  84. "Proportion": 50,
  85. "Code": 403
  86. },
  87. {
  88. "Count": 1,
  89. "Proportion": 50,
  90. "Code": 404
  91. }
  92. ]
  93. }
  94. },
  95. {
  96. "TimeStamp": "2018-03-01T05:00:00Z",
  97. "HttpCode": {
  98. "HttpCodeDataModule": [
  99. {
  100. "Count": 1,
  101. "Proportion": 33.33333333333333,
  102. "Code": 404
  103. },
  104. {
  105. "Count": 1,
  106. "Proportion": 33.33333333333333,
  107. "Code": 504
  108. },
  109. {
  110. "Count": 1,
  111. "Proportion": 33.33333333333333,
  112. "Code": 502
  113. }
  114. ]
  115. }
  116. }
  117. ]
  118. }
  119. }

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.
IllegalOperation Illegal domain, operation is not permitted. 403 The error message returned when the domain name is invalid.
OperationDenied Your account does not open CDN service yet. 403 The error message returned when the CDN service is not activated.
OperationDenied Your CDN service is suspended. 403 The error message returned when the CDN service is disabled.
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 the current user.
InvalidDomain.Offline The domain provided is offline. 404 The error message returned when the domain name has been taken offline.
ServiceBusy The specified Domain is configuring, please retry later. 403 The error message returned when the domain name is being configured. Please try again later.
InvalidDomain.Configure_failed Failed to configure the provided domain. 500 The error message returned when the domain name configuration fails.
MissingParameter StartTime and EndTime can not be single. 400 The error message returned because you must specify both the StartTime and EndTime parameters.
InvalidStartTime.Malformed Specified start time is malformed. 400 The error message returned when the format of the StartTime value is incorrect.
InvalidEndTime.Malformed Specified end time is malformed. 400 The error message returned when the format of the EndTime value is incorrect.
InvalidEndTime.Mismatch Specified end time does not math the specified start time. 400 The error message returned when the specified end time is earlier than the start time.
InvalidStartTime.ValueNotSupported Specified end time does not math the specified start time. 400 The error message returned when the end time is more than 90 days later than the start time.