查询域名推流状态码

调用DescribeLiveDomainPublishErrorCode查询推流域名下某个时间段内的推流状态码。

使用说明

  • 本接口为监控数据接口,数据采集处理方式不同于计费,不能用于计算用量进行对账参考。
  • 最多可获取最近90天的数据。
  • 接口数据延时在3-5分钟。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称

类型

是否必选

示例值

描述

Action String DescribeLiveDomainPublishErrorCode

系统规定参数。取值:DescribeLiveDomainPublishErrorCode

DomainName String example.com,example.aliyundoc.com

推流域名,允许传入多个推流域名,多个域名之间用英文逗号(,)分隔。

说明 该参数为必填参数。
AppName String AppName

按照AppName进行过滤汇聚,若指定了AppName,则DomainName必须指定一个特定的推流域名。

StartTime String 2016-06-29T09:00:00Z

起始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

说明 不写默认查询过去1小时的数据。
EndTime String 2016-06-29T09:10:00Z

结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

说明 不写默认查询过去1小时的数据。

返回数据

名称

类型

示例值

描述

DataInterval String 60

查询数据的时间粒度,单位是秒。默认值为60。

DomainName String example.com,example.aliyundoc.com

推流域名。

EndTime String 2016-06-29T09:10:00Z

结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

RealTimeCodeData Array of rtcd

每个时间间隔的错误码占比数据。

CodeData Array of cd

各返回码占比使用数据列表。

Code String 200

响应码。响应码取值:

  • 3:读数据超时 。
  • 4:写数据错误 。
  • 6:写数据超时 。
  • 200:成功。
  • 500:内部系统未知错误 。
  • 501:推流异常。
  • 502:信令耗时过长 。
  • 401:推流参数异常 。
  • 403:推流鉴权失败。
Count String 20

响应数量。

Proportion String 66.04

响应数量占比。

TimeStamp String 2016-06-29T09:01:00Z

时间片起始时刻。

RequestId String BC858082-736F-4A25-867B-E5B67C85ACF7

请求ID。

StartTime String 2016-06-29T09:00:00Z

起始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainPublishErrorCode
&DomainName=example.com,example.aliyundoc.com
&AppName=AppName
&StartTime=2016-06-29T09:00:00Z
&EndTime=2016-06-29T09:10:00Z
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeLiveDomainPublishErrorCodeResponse>
    <RequestId>BC858082-736F-4A25-867B-E5B67C85ACF7</RequestId>
    <DataInterval>60</DataInterval>
    <DomainName>example.com,example.aliyundoc.com</DomainName>
    <StartTime>2016-06-29T09:00:00Z</StartTime>
    <EndTime>2016-06-29T09:10:00Z</EndTime>
    <RealTimeCodeData>
        <TimeStamp>2016-06-29T09:01:00Z</TimeStamp>
        <CodeData>
            <Code>200</Code>
            <Count>20</Count>
            <Proportion>66.04</Proportion>
        </CodeData>
    </RealTimeCodeData>
</DescribeLiveDomainPublishErrorCodeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "BC858082-736F-4A25-867B-E5B67C85ACF7",
  "DataInterval" : 60,
  "DomainName" : "example.com,example.aliyundoc.com",
  "StartTime" : "2016-06-29T09:00:00Z",
  "EndTime" : "2016-06-29T09:10:00Z",
  "RealTimeCodeData" : {
    "TimeStamp" : "2016-06-29T09:01:00Z",
    "CodeData" : {
      "Code" : 200,
      "Count" : 20,
      "Proportion" : 66.04
    }
  }
}

错误码

访问错误中心查看更多错误码。