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

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

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.