DescribeDomainReqHitRateData - API Reference| Alibaba Cloud Documentation Center

Description

Obtain the request hit rate (percentage of hit requests) of CDN domain names.
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	The end time must be later than the start time. The date format adopts ISO8601 notation and uses the UTC time. Format: YYYY-MM-DDThh:mmZ.
Interval	String	No	300	Time granularity of data query. 300s, 3600s, 14400s, 28800s and 86400s are supported. When the parameter is left blank or when the value is not supported, the default value 300 seconds is used.
StartTime	String	No	2017-12-21T08:00:00:00Z	Start time of data query. The date format adopts ISO8601 notation and uses the UTC time. Format: YYYY-MM-DDThh:mmZ. Minimum data granularity: 5 minutes. If this parameter is unspecified, data from the past 24 hours is read by default.

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	The ID of the request.

Example

Return 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"
}

Exception return example

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"
}

Error code

For more information, see Error code of this product.