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

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 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.