Obtains the request hit rate (percentage of hit requests) of CDN domains.
- When StartTime and EndTime are not specified, the system reads data from the past 24 hours by default. Query by specified start time and end time is also supported. The two parameters must be both specified.
- Batch domain name query is supported. Multiple domain names are separated by commas (half width).
- Data from the past 90 days can be obtained at most.
Request parameters
Parameters | Type | Required | Example values | Description |
Action | String | Yes | DescribeDomainReqHitRateData | The name of this interface. Value: DescribeDomainReqHitRateData |
DomainName | String | No | www.yourdomain.com | CDN domain to be queried. This parameter can be set to support only one domain name. If this parameter is left blank, the system queries all domain names. |
EndTime | String | No | 2017-12-22T08:00:00:00Z |
|
Interval | String | No | 300 |
|
StartTime | String | No | 2017-12-21T08:00:00:00Z |
|
Return parameters
Parameters | Type | Example values | Description |
DomainName | String | test.com | CDN domain name information. |
DataInterval | String | 300 | Interval of each record. The unit is seconds. |
StartTime | String | 2015-12-10T20:00Z | Start time. |
EndTime | String | 2015-12-10T21:00Z | End time. |
ReqHitRateInterval | Bytes hit rate during each interval. | ||
└TimeStamp | String | 2017-12-22T08:00:00:00Z | Start time of a time slice |
└Value | String | 100.0 | Detailed usage data. |
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 | Request ID. |
Example
Request example
http://cdn.aliyuncs.com?Action=DescribeDomainReqHitRateData&DomainName=test.com
&StartTime=2015-12-10T20:00Z
&EndTime=2015-12-10T21:00Z
&public request parameter
Normal return example
-
JSON format
{ "DataInterval":"300", "DomainName":"test.com", "EndTime":"2015-12-10T21:00Z", "ReqHitRateInterval":{ "DataModule":[ { "TimeStamp":"2015-12-10T21:00:00Z", "Value":"100.0" }, { "TimeStamp":"2015-12-10T20:35:00Z", "Value":"100.0" }, { "TimeStamp":"2015-12-10T20:50:00Z", "Value":"99.99932881437826" }, { "TimeStamp":"2015-12-10T20:05:00Z", "Value":"100.0" }, { "TimeStamp":"2015-12-10T20:10:00Z", "Value":"100.0" }, { "TimeStamp":"2015-12-10T20:55:00Z", "Value":"100.0" }, { "TimeStamp":"2015-12-10T20:30:00Z", "Value":"100.0" }, { "TimeStamp":"2015-12-10T20:25:00Z", "Value":"100.0" }, { "TimeStamp":"2015-12-10T20:00:00Z", "Value":"100.0" }, { "TimeStamp":"2015-12-10T20:40:00Z", "Value":"100.0" }, { "TimeStamp":"2015-12-10T20:15:00Z", "Value":"100.0" }, { "TimeStamp":"2015-12-10T20:45:00Z", "Value":"100.0" }, { "TimeStamp":"2015-12-10T20:20:00Z", "Value":"100.0" } ] }, "RequestId":"5ADA5190-EE5B-4EF2-BE00-DC441B8D81DD", "StartTime":"2015-12-10T20:00Z" }
-
JSON format
{ "Code":"InternalError", "HostId":"cdn.aliyuncs.com", "Message":"The request processing has failed due to some unknown error.", "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8" }