Queries the total number and proportions of HTTP status codes returned from an accelerated domain name.
Usage notes
- The maximum number of times that each user can call this operation per second is 10.
- If you do not set StartTime or EndTime, data collected within the last hour is queried. If you set both StartTime and EndTime, data collected within the specified time range is queried.
The time granularity varies with the time range specified by the StartTime and EndTime parameters. The following table describes the time period within which historical data is available and the data delay.
Time granularity |
Historical data available |
Time range to query |
Data delay |
---|---|---|---|
1 minute |
1 hour |
7 days |
5 minutes |
5 minutes |
3 days |
93 days |
15 minutes |
1 hour |
31 days |
186 days |
4 hours |
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeDomainRealTimeHttpCodeData |
The operation that you want to perform. Set the value to DescribeDomainRealTimeHttpCodeData. |
DomainName | String | Yes | example.com,example.org |
The accelerated domain names. You can specify multiple accelerated domain names and separate them with commas (,). Note You can specify at most 100 accelerated domain names in each call.
|
StartTime | String | No | 2019-11-30T05:39:00Z |
The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. |
EndTime | String | No | 2019-11-30T05:40:00Z |
The end of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. Note The end time must be later than the start time.
|
IspNameEn | String | No | unicom |
The name of the Internet service provider (ISP) for your Alibaba Cloud CDN service. You can call the DescribeCdnRegionAndIsp operation to query ISP names. |
LocationNameEn | String | No | beijing |
The name of the region. If you do not set this parameter, all regions are queried. You can call the DescribeCdnRegionAndIsp operation to query the most recent region list. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
EndTime | String | 2019-11-29T05:42:00Z |
The end of the time range that was queried. |
StartTime | String | 2019-11-29T05:39:00Z |
The beginning of the time range that was queried. |
RequestId | String | BC858082-736F-4A25-867B-E5B67C85ACF7 |
The ID of the request. |
DomainName | String | example.com,example.org |
The accelerated domain name. |
DataInterval | String | 60 |
The time interval between the data entries returned. Unit: seconds. The time granularity varies with the time range to query. Supported values: 60 (1 minute), 300 (5 minutes), and 3600(1 hour). For more information, see the usage notes. |
RealTimeHttpCodeData | Array of UsageData |
The proportions of HTTP status codes at each time interval. |
|
UsageData | |||
TimeStamp | String | 2019-11-29T05:39:00Z |
The timestamp of the data returned. |
Value | Array of RealTimeCodeProportionData |
The proportions of the HTTP status codes. |
|
RealTimeCodeProportionData | |||
Code | String | 500 |
The HTTP status code. |
Proportion | String | 28.4496124031008 |
The proportion of the HTTP status code. |
Count | String | 100 |
The total number of HTTP status codes returned. |
Examples
Sample requests
http(s)://cdn.aliyuncs.com/?Action=DescribeDomainRealTimeHttpCodeData
&DomainName=example.com,example.org
&StartTime=2019-11-29T05:39:00Z
&EndTime=2019-11-29T05:42:00Z
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeDomainRealTimeHttpCodeDataResponse>
<DataInterval>60</DataInterval>
<RequestId>99E690FC-86A3-4533-8F61-CF9E319141A4</RequestId>
<DomainName>example.com,example.org</DomainName>
<EndTime>2019-11-29T05:42:00Z</EndTime>
<StartTime>2019-11-29T05:39:00Z</StartTime>
<RealTimeHttpCodeData>
<UsageData>
<TimeStamp>2019-11-29T05:39:00Z</TimeStamp>
<Value>
<RealTimeCodeProportionData>
<Count>2</Count>
<Proportion>100</Proportion>
<Code>200</Code>
</RealTimeCodeProportionData>
</Value>
</UsageData>
<UsageData>
<TimeStamp>2019-11-29T05:40:00Z</TimeStamp>
<Value>
<RealTimeCodeProportionData>
<Count>1</Count>
<Proportion>50</Proportion>
<Code>200</Code>
</RealTimeCodeProportionData>
<RealTimeCodeProportionData>
<Count>1</Count>
<Proportion>50</Proportion>
<Code>304</Code>
</RealTimeCodeProportionData>
</Value>
</UsageData>
<UsageData>
<TimeStamp>2019-11-29T05:41:00Z</TimeStamp>
<Value>
<RealTimeCodeProportionData>
<Count>11</Count>
<Proportion>91.66666666666666</Proportion>
<Code>200</Code>
</RealTimeCodeProportionData>
<RealTimeCodeProportionData>
<Count>1</Count>
<Proportion>8.333333333333332</Proportion>
<Code>206</Code>
</RealTimeCodeProportionData>
</Value>
</UsageData>
</RealTimeHttpCodeData>
</DescribeDomainRealTimeHttpCodeDataResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"DataInterval" : 60,
"RequestId" : "99E690FC-86A3-4533-8F61-CF9E319141A4",
"DomainName" : "example.com,example.org",
"EndTime" : "2019-11-29T05:42:00Z",
"StartTime" : "2019-11-29T05:39:00Z",
"RealTimeHttpCodeData" : {
"UsageData" : [ {
"TimeStamp" : "2019-11-29T05:39:00Z",
"Value" : {
"RealTimeCodeProportionData" : [ {
"Count" : 2,
"Proportion" : 100,
"Code" : "200"
} ]
}
}, {
"TimeStamp" : "2019-11-29T05:40:00Z",
"Value" : {
"RealTimeCodeProportionData" : [ {
"Count" : 1,
"Proportion" : 50,
"Code" : "200"
}, {
"Count" : 1,
"Proportion" : 50,
"Code" : "304"
} ]
}
}, {
"TimeStamp" : "2019-11-29T05:41:00Z",
"Value" : {
"RealTimeCodeProportionData" : [ {
"Count" : 11,
"Proportion" : "91.66666666666666",
"Code" : "200"
}, {
"Count" : 1,
"Proportion" : "8.333333333333332",
"Code" : "206"
} ]
}
} ]
}
}
Error codes
For a list of error codes, visit the API Error Center.