Queries the limits on the numbers of ingested streams, transcoded streams, and relayed streams under a streaming domain.
Usage notes
The streaming domain that is used for this operation must be a main streaming domain.
QPS limit
You can call this operation up to five times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, 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 name of the main streaming domain. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | A3136B58-5876-4168-83CA-B562781981A0 |
The ID of the request. |
LiveDomainLimitList | Array of LiveDomainLimit |
The limits on the numbers of ingested streams, transcoded streams, and ingested streams. |
|
LiveDomainLimit | |||
LimitTranscodeNum | Integer | 50 |
The limit on the number of transcoded streams. |
LimitNum | Integer | 100 |
The limit on the number of ingested streams. |
LimitTransferNum | Integer | 50 |
The limit on the number of relayed streams. |
DomainName | String | example.com |
The main streaming domain that was queried. |
Examples
Sample request
http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainLimit
&DomainName=example.com
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeLiveDomainLimitResponse>
<RequestId>A3136B58-5876-4168-83CA-B562781981A0</RequestId>
<LiveDomainLimitList>
<LiveDomainLimit>
<DomainName>example.com</DomainName>
<LimitNum>100</LimitNum>
<LimitTranscodeNum>50</LimitTranscodeNum>
<LimitTransferNum>50</LimitTransferNum>
</LiveDomainLimit>
</LiveDomainLimitList>
</DescribeLiveDomainLimitResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"DescribeLiveDomainLimitResponse" : {
"RequestId" : "A3136B58-5876-4168-83CA-B562781981A0",
"LiveDomainLimitList" : {
"LiveDomainLimit" : {
"DomainName" : "example.com",
"LimitNum" : 100,
"LimitTranscodeNum" : 50,
"LimitTransferNum" : 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 one or more required parameters are 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 cannot be found under your Alibaba Cloud account. |