Queries the proportions of HTTP status codes in a minute for domain names for CDN.

  • The time range that is specified by the StartTime and EndTime parameters cannot exceed 24 hours for a query.
  • You can query the data of the last 7 days at most.
  • This operation can be called up to 10 times per second.

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 test.com,abc.com

The streaming domain.

Separate multiple domain names with commas (,).

StartTime String No 2015-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.

Note If you do not specify this parameter, the data that is collected in the last hour is returned.
EndTime String No 2015-11-30T05:40:00Z

The end of the time range to query. The end time must be later than the start time. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

IspNameEn String No alibaba

The name of the Internet service provider (ISP).

To query ISPs, call the DescribeCdnRegionAndIsp operation.

LocationNameEn String No tianjin

The name of the region.

To query regions, call the DescribeCdnRegionAndIsp operation.

Response parameters

Parameter Type Example Description
DataInterval String 60

The time interval between the returned entries. Unit: seconds. Default value: 60.

DomainName String test.com,abc.com

The streaming domain.

EndTime String 2015-11-30T05:40:00Z

The end of the time range in which the 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 for each interval.

UsageData
TimeStamp String 2015-11-30T05:39:00Z

The timestamp of the returned data.

Value Array of RealTimeCodeProportionData

The proportions of each HTTP status code.

RealTimeCodeProportionData
Code String 200

The HTTP status code.

Count String 20

The total number of the HTTP status codes returned.

Proportion String 66.046511627907

The proportions of the HTTP status code.

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 in which the 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 requests

http(s)://live.aliyuncs.com/? Action=DescribeLiveDomainRealTimeHttpCodeData
&DomainName=test.com,abc.com
&<Common request parameters>

Sample success responses

XML format

<DescribeLiveDomainRealTimeHttpCodeDataResponse>
  <RequestId>17EA7ECB-8711-4002-865D-083771BF95E4</RequestId>
  <EndTime>2020-12-09T7:30:00Z</EndTime>
  <DomainName>pull.grtn.aliyunlive.com</DomainName>
  <DataInterval>60</DataInterval>
  <StartTime>2020-12-09T7:20:00Z</StartTime>
  <RealTimeHttpCodeData>
        <UsageData>
              <Value>
                    <RealTimeCodeProportionData>
                          <Proportion>100</Proportion>
                          <Count>6</Count>
                          <Code>200</Code>
                    </RealTimeCodeProportionData>
              </Value>
              <TimeStamp>2020-12-09T07:20:00Z</TimeStamp>
        </UsageData>
        <UsageData>
              <Value>
                    <RealTimeCodeProportionData>
                          <Proportion>100</Proportion>
                          <Count>6</Count>
                          <Code>200</Code>
                    </RealTimeCodeProportionData>
              </Value>
              <TimeStamp>2020-12-09T07:21:00Z</TimeStamp>
        </UsageData>
        <UsageData>
              <Value>
                    <RealTimeCodeProportionData>
                          <Proportion>100</Proportion>
                          <Count>6</Count>
                          <Code>200</Code>
                    </RealTimeCodeProportionData>
              </Value>
              <TimeStamp>2020-12-09T07:22:00Z</TimeStamp>
        </UsageData>
        <UsageData>
              <Value>
                    <RealTimeCodeProportionData>
                          <Proportion>100</Proportion>
                          <Count>6</Count>
                          <Code>200</Code>
                    </RealTimeCodeProportionData>
              </Value>
              <TimeStamp>2020-12-09T07:23:00Z</TimeStamp>
        </UsageData>
        <UsageData>
              <Value>
                    <RealTimeCodeProportionData>
                          <Proportion>100</Proportion>
                          <Count>6</Count>
                          <Code>200</Code>
                    </RealTimeCodeProportionData>
              </Value>
              <TimeStamp>2020-12-09T07:24:00Z</TimeStamp>
        </UsageData>
        <UsageData>
              <Value>
                    <RealTimeCodeProportionData>
                          <Proportion>100</Proportion>
                          <Count>6</Count>
                          <Code>200</Code>
                    </RealTimeCodeProportionData>
              </Value>
              <TimeStamp>2020-12-09T07:25:00Z</TimeStamp>
        </UsageData>
        <UsageData>
              <Value>
                    <RealTimeCodeProportionData>
                          <Proportion>100</Proportion>
                          <Count>6</Count>
                          <Code>200</Code>
                    </RealTimeCodeProportionData>
              </Value>
              <TimeStamp>2020-12-09T07:26:00Z</TimeStamp>
        </UsageData>
        <UsageData>
              <Value>
                    <RealTimeCodeProportionData>
                          <Proportion>100</Proportion>
                          <Count>6</Count>
                          <Code>200</Code>
                    </RealTimeCodeProportionData>
              </Value>
              <TimeStamp>2020-12-09T07:27:00Z</TimeStamp>
        </UsageData>
        <UsageData>
              <Value>
                    <RealTimeCodeProportionData>
                          <Proportion>100</Proportion>
                          <Count>6</Count>
                          <Code>200</Code>
                    </RealTimeCodeProportionData>
              </Value>
              <TimeStamp>2020-12-09T07:28:00Z</TimeStamp>
        </UsageData>
        <UsageData>
              <Value>
                    <RealTimeCodeProportionData>
                          <Proportion>100</Proportion>
                          <Count>6</Count>
                          <Code>200</Code>
                    </RealTimeCodeProportionData>
              </Value>
              <TimeStamp>2020-12-09T07:29:00Z</TimeStamp>
        </UsageData>
  </RealTimeHttpCodeData>
</DescribeLiveDomainRealTimeHttpCodeDataResponse>

JSON format

{
    "RequestId": "17EA7ECB-8711-4002-865D-083771BF95E4",
    "EndTime": "2020-12-09T7:30:00Z",
    "DomainName": "pull.grtn.aliyunlive.com",
    "DataInterval": 60,
    "StartTime": "2020-12-09T7:20:00Z",
    "RealTimeHttpCodeData": {
        "UsageData": [
            {
                "Value": {
                    "RealTimeCodeProportionData": [
                        {
                            "Proportion": 100,
                            "Count": 6,
                            "Code": "200"
                        }
                    ]
                },
                "TimeStamp": "2020-12-09T07:20:00Z"
            },
            {
                "Value": {
                    "RealTimeCodeProportionData": [
                        {
                            "Proportion": 100,
                            "Count": 6,
                            "Code": "200"
                        }
                    ]
                },
                "TimeStamp": "2020-12-09T07:21:00Z"
            },
            {
                "Value": {
                    "RealTimeCodeProportionData": [
                        {
                            "Proportion": 100,
                            "Count": 6,
                            "Code": "200"
                        }
                    ]
                },
                "TimeStamp": "2020-12-09T07:22:00Z"
            },
            {
                "Value": {
                    "RealTimeCodeProportionData": [
                        {
                            "Proportion": 100,
                            "Count": 6,
                            "Code": "200"
                        }
                    ]
                },
                "TimeStamp": "2020-12-09T07:23:00Z"
            },
            {
                "Value": {
                    "RealTimeCodeProportionData": [
                        {
                            "Proportion": 100,
                            "Count": 6,
                            "Code": "200"
                        }
                    ]
                },
                "TimeStamp": "2020-12-09T07:24:00Z"
            },
            {
                "Value": {
                    "RealTimeCodeProportionData": [
                        {
                            "Proportion": 100,
                            "Count": 6,
                            "Code": "200"
                        }
                    ]
                },
                "TimeStamp": "2020-12-09T07:25:00Z"
            },
            {
                "Value": {
                    "RealTimeCodeProportionData": [
                        {
                            "Proportion": 100,
                            "Count": 6,
                            "Code": "200"
                        }
                    ]
                },
                "TimeStamp": "2020-12-09T07:26:00Z"
            },
            {
                "Value": {
                    "RealTimeCodeProportionData": [
                        {
                            "Proportion": 100,
                            "Count": 6,
                            "Code": "200"
                        }
                    ]
                },
                "TimeStamp": "2020-12-09T07:27:00Z"
            },
            {
                "Value": {
                    "RealTimeCodeProportionData": [
                        {
                            "Proportion": 100,
                            "Count": 6,
                            "Code": "200"
                        }
                    ]
                },
                "TimeStamp": "2020-12-09T07:28:00Z"
            },
            {
                "Value": {
                    "RealTimeCodeProportionData": [
                        {
                            "Proportion": 100,
                            "Count": 6,
                            "Code": "200"
                        }
                    ]
                },
                "TimeStamp": "2020-12-09T07:29:00Z"
            }
        ]
    }
}

Error codes

For a list of error codes, visit the API Error Center.