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

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

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.