Queries the quantity limits on stream pushing and transcoding under a streaming domain.
Usage note
This operation is applicable to the main streaming domains.
QPS limit
A single user can perform a maximum of 5 queries per second (QPS). Throttling is triggered when the number of calls per second exceeds the QPS limit. The throttling may affect your business. Thus, we recommend that you observe the QPS limit on this operation. For more information about what a single user means and the QPS details, see QPS limit on an API operation in ApsaraVideo Live.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeLiveDomainLimit |
The operation that you want to perform. Set the value to DescribeLiveDomainLimit. |
DomainName | String | Yes | example.com |
The main streaming domain. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
LiveDomainLimitList | Array of LiveDomainLimit |
The list of quantity limits on stream pushing and transcoding. |
|
LiveDomainLimit | |||
DomainName | String | example.com |
The name of the main streaming domain. |
LimitNum | Integer | 100 |
The quantity limit on stream pushing. Unit: stream. |
LimitTranscodeNum | Integer | 50 |
The quantity limit on transcoding. Unit: stream. |
RequestId | String | A3136B58-5876-4168-83CA-B562781981A0 |
The ID of the request. |
Examples
Sample requests
http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainLimit
&DomainName=example.com
&<Common request parameters>
Sample success responses
XML
format
<DescribeLiveDomainLimitResponse>
<RequestId>A3136B58-5876-4168-83CA-B562781981A0</RequestId>
<LiveDomainLimitList>
<LiveDomainLimit>
<DomainName>example.com</DomainName>
<LimitNum>100</LimitNum>
<LimitTranscodeNum>50</LimitTranscodeNum>
</LiveDomainLimit>
</LiveDomainLimitList>
</DescribeLiveDomainLimitResponse>
JSON
format
{
"RequestId": "A3136B58-5876-4168-83CA-B562781981A0",
"LiveDomainLimitList": {
"LiveDomainLimit":[
{
"DomainName": "example.com",
"LimitNum": 100,
"LimitTranscodeNum": 50
}
]
}
}
Error codes
For a list of error codes, visit the API Error Center.
Special error codes
Error code |
Error message |
HTTP status code |
Description |
---|---|---|---|
Missing DomainName |
DomainName is mandatory for this action. |
400 |
The error message returned because a required parameter is not specified. |
InvalidParam |
Parameter invalid. |
400 |
The error message returned because one or more parameters are invalid. |
InvalidDomain.NotFound |
The domain provided does not exist in our records. |
404 |
The error message returned because the domain name does not belong to your Alibaba Cloud account. |