调用DescribeLiveDomainLimit查询指定播流域名的推流数量限制和转码数量限制。

使用说明

本接口支持的播流域名为主播流域名。

QPS限制

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeLiveDomainLimit

系统规定参数。取值:

DescribeLiveDomainLimit

DomainName String example.com

主播流域名。

RegionId String cn-shanghai

域名所属地域。

返回数据

名称 类型 示例值 描述
LiveDomainLimitList Array of LiveDomainLimit

推流数量限制和转码数量限制列表。

LiveDomainLimit
DomainName String example.com

您查询的主播流域名。

LimitNum Integer 100

推流数量限制。单位:个。

LimitTranscodeNum Integer 50

转码数量限制。单位:个。

RequestId String A3136B58-5876-4168-83CA-B562781981A0

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainLimit
&DomainName=example.com
&<公共请求参数>

正常返回示例

XML格式

<DescribeLiveDomainLimitResponse>
      <RequestId>A3136B58-5876-4168-83CA-B562781981A0</RequestId>
      <LiveDomainLimitList>
            <LiveDomainLimit>
                  <DomainName>example.com</DomainName>
                 <LimitNum>100</LimitNum>
                  <LimitTranscodeNum>50</LimitTranscodeNum>
            </LiveDomainLimit>
      </LiveDomainLimitList>
</DescribeLiveDomainLimitResponse>

JSON格式

{
    "DescribeLiveDomainLimitResponse": {
        "RequestId": "A3136B58-5876-4168-83CA-B562781981A0",
        "LiveDomainLimitList": {
            "LiveDomainLimit": {
                "DomainName": "example.com",
                "LimitNum": 100,
                "LimitTranscodeNum": 50
            }
        }
    }
}

错误码

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

特殊错误码

错误代码

描述

HTTP 状态码

语义

Missing DomainName

DomainName is mandatory for this action.

400

缺少参数。

InvalidParam

Parameter invalid.

400

参数错误。

InvalidDomain.NotFound

The domain provided does not exist in our records.

404

当前账户下未查到此域名。