Queries the maximum numbers of ingested, transcoded, and relayed streams for a streaming domain.
Usage notes
This operation applies only to main streaming domains.
QPS limits
You can call this operation up to 5 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 limits.
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 maximum numbers of ingested, transcoded, and relayed streams for the queried streaming domain. |
|
LiveDomainLimit | |||
LimitTranscodeNum | Integer | 50 | The maximum number of transcoded streams. |
CurrentTranscodeNum | Integer | 10 | The current number of transcoded streams. |
LimitNum | Integer | 100 | The maximum number of ingested streams. |
LimitTransferNum | Integer | 50 | The maximum number of relayed streams. |
CurrentNum | Integer | 10 | The current number of ingested streams. |
CurrentTransferNum | Integer | 10 | The current number of relayed streams. |
DomainName | String | example.com | The name of the queried main streaming domain. |
Examples
Sample requests
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>
<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
format
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"
}
}
Common error codes
For a list of error codes, see Service error codes.
Operation-specific error codes
Error code |
Error message |
HTTP status code |
Description |
Missing DomainName |
DomainName is mandatory for this action. |
400 |
One or more required parameters are not specified. |
InvalidParam |
Parameter invalid. |
400 |
One or more specified parameters are invalid. |
InvalidDomain.NotFound |
The domain provided does not exist in our records. |
404 |
The domain name cannot be found in the current Alibaba Cloud account. |