调用DescribeLiveDomainLimit查询指定播流域名的推流数量、转码数量和转推数量限制。
使用说明
本接口支持的播流域名为主播流域名。
QPS限制
本接口的单用户QPS限制为5次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | DescribeLiveDomainLimit | 系统规定参数。取值:DescribeLiveDomainLimit。 |
DomainName | String | 是 | example.com | 主播流域名。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | A3136B58-5876-4168-83CA-B562781981A0 | 请求ID。 |
LiveDomainLimitList | Array of LiveDomainLimit | 推流数量限制和转码数量限制列表。 |
|
LiveDomainLimit | |||
LimitTranscodeNum | Integer | 50 | 转码数量限制。单位:个。 |
CurrentTranscodeNum | Integer | 10 | 域名当前的转码流数量。 |
LimitNum | Integer | 100 | 推流数量限制。单位:个。 |
LimitTransferNum | Integer | 50 | 中心转推数量限制,单位:个。 |
CurrentNum | Integer | 10 | 域名当前的原始流数量。 |
CurrentTransferNum | Integer | 10 | 域名当前的中心转推流数量。 |
DomainName | String | example.com | 您查询的主播流域名。 |
示例
请求示例
http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainLimit
&DomainName=example.com
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeLiveDomainLimitResponse>
<RequestId>A3136B58-5876-4168-83CA-B562781981A0</RequestId>
<LiveDomainLimitList>
<LimitTranscodeNum>50</LimitTranscodeNum>
<CurrentTranscodeNum>10</CurrentTranscodeNum>
<LimitNum>100</LimitNum>
<LimitTransferNum>50</LimitTransferNum>
<CurrentNum>10</CurrentNum>
<CurrentTransferNum>10</CurrentTransferNum>
<DomainName>example.com</DomainName>
</LiveDomainLimitList>
</DescribeLiveDomainLimitResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "A3136B58-5876-4168-83CA-B562781981A0",
"LiveDomainLimitList" : {
"LimitTranscodeNum" : 50,
"CurrentTranscodeNum" : 10,
"LimitNum" : 100,
"LimitTransferNum" : 50,
"CurrentNum" : 10,
"CurrentTransferNum" : 10,
"DomainName" : "example.com"
}
}
错误码
访问错误中心查看更多错误码。
特殊错误码
错误代码 |
描述 |
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 |
当前账户下未查到此域名。 |