Queries the proportions of HTTP status codes for accelerated domain names. The minimum time granularity is 1 minute.
Description
The following table describes the time granularity for data queries when you call this operation.
Time granularity |
Maximum time range per query |
Historical data available |
Data delay |
---|---|---|---|
1 minute |
1 hour |
7 days |
5 minutes |
5 minutes |
3 days |
93 days |
15 minutes |
1 hour |
31 days |
186 days |
Generally 4 hours |
1 day |
Unlimited |
366 days |
After 04:00 the next day |
QPS limit
You can call this operation up to 10 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation. For more information, see QPS limit.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeLiveDomainRealTimeHttpCodeData |
The operation that you want to perform. Set the value to DescribeLiveDomainRealTimeHttpCodeData. |
DomainName | String | Yes | example.com,example.aliyundoc.com |
The streaming domain name. Separate multiple domain names with commas (,). |
RegionId | String | No | cn-shanghai |
The ID of the region. |
StartTime | String | No | 2015-11-30T05:39:00Z |
The beginning of the time range during which you want to query data. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. Note If you specify neither StartTime nor EndTime, the data in the last hour is returned.
|
EndTime | String | No | 2015-11-30T05:40:00Z |
The end of the time range during which you want to query data. The end time must be later than the beginning time. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. Note If you specify neither the StartTime parameter nor the EndTime parameter, the data
in the last hour is returned.
|
IspNameEn | String | No | alibaba |
The name of the Internet service provider (ISP). You can call the DescribeCdnRegionAndIsp operation to query a list of available ISPs. |
LocationNameEn | String | No | tianjin |
The name of the region. You can call the DescribeCdnRegionAndIsp operation to query a list of available regions. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
DataInterval | String | 60 |
The time interval between the returned entries. Unit: seconds. Default value: 60. |
DomainName | String | example.com,example.aliyundoc.com |
The streaming domain name. |
EndTime | String | 2015-11-30T05:40:00Z |
The end of the time range during which data was queried. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC. |
RealTimeHttpCodeData | Array of UsageData |
The proportions of HTTP status codes at each time interval. |
|
UsageData | |||
TimeStamp | String | 2015-11-30T05:39:00Z |
The timestamp of the returned data. |
Value | Array of RealTimeCodeProportionData |
The proportions of HTTP status codes. |
|
RealTimeCodeProportionData | |||
Code | String | 200 |
The HTTP status code. |
Count | String | 20 |
The total number of the returned HTTP status codes. |
Proportion | String | 66.046511627907 |
The proportion of the returned HTTP status codes. |
RequestId | String | BC858082-736F-4A25-867B-E5B67C85ACF7 |
The ID of the request. |
StartTime | String | 2015-11-30T05:33:00Z |
The beginning of the time range during which data was queried. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC. |
Examples
Sample request
http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainRealTimeHttpCodeData
&DomainName=example.com,example.aliyundoc.com
&<Common request parameters>
Sample success responses
XML
format
<DescribeLiveDomainRealTimeHttpCodeDataResponse>
<EndTime>2015-11-30T05:40:00Z</EndTime>
<RequestId>BC858082-736F-4A25-867B-E5B67C85ACF7</RequestId>
<DomainName>example.com,example.aliyundoc.com</DomainName>
<DataInterval>60</DataInterval>
<StartTime>2015-11-30T05:33:00Z</StartTime>
<RealTimeHttpCodeData>
<UsageData>
<TimeStamp>2015-11-30T05:39:00Z</TimeStamp>
<Value>
<RealTimeCodeProportionData>
<Proportion>66.046511627907</Proportion>
<Count>20</Count>
<Code>200</Code>
</RealTimeCodeProportionData>
</Value>
</UsageData>
</RealTimeHttpCodeData>
</DescribeLiveDomainRealTimeHttpCodeDataResponse>
JSON
format
{
"DescribeLiveDomainRealTimeHttpCodeDataResponse": {
"EndTime": "2015-11-30T05:40:00Z",
"RequestId": "BC858082-736F-4A25-867B-E5B67C85ACF7",
"DomainName": "example.com,example.aliyundoc.com",
"DataInterval": 60,
"StartTime": "2015-11-30T05:33:00Z",
"RealTimeHttpCodeData": {
"UsageData": {
"TimeStamp": "2015-11-30T05:39:00Z",
"Value": {
"RealTimeCodeProportionData": {
"Proportion": 66.046511627907,
"Count": 20,
"Code": 200
}
}
}
}
}
}
Error codes
For a list of error codes, visit the API Error Center.