Queries the configurations that trigger stream pulling under a streaming domain.

Usage note

This interface is applicable to the triggered stream pulling.

QPS limit

A single user can perform a maximum of 1000 queries per minute (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 DescribeLiveLazyPullStreamConfig

The operation that you want to perform. Set the value to DescribeLiveLazyPullStreamConfig.

DomainName String Yes example.com

The main streaming domain.

AppName String No liveApp****

The name of the application to which the live stream belongs.

Response parameters

Parameter Type Example Description
LiveLazyPullConfigList Array of LiveLazyPullConfig

The stream pulling configurations.

LiveLazyPullConfig
AppName String liveApp****

The name of the application.

DomainName String example.com

The main streaming domain.

PullAppName String livePullApp****

The name of the application for back-to-origin stream pulling. If the application specified in the streaming URL is used, this parameter is left empty.

PullDomainName String guide.aliyundoc.com

The domain name for back-to-origin stream pulling.

PullProtocol String RTMP

The protocol for back-to-origin stream pulling. Valid values:

  • RTMP
  • HTTP-FLV
RequestId String A3136B58-5876-4168-83CA-B562781981A0

The ID of the request.

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=DescribeLiveLazyPullStreamConfig
&DomainName=example.com
&<Common request parameters>

Sample success responses

XML format

<DescribeLiveLazyPullStreamConfigResponse>
  <RequestId>A3136B58-5876-4168-83CA-B562781981A0</RequestId>
  <LiveLazyPullConfigList>
        <LiveLazyPullConfig>
              <PullProtocol>RTMP</PullProtocol>
              <DomainName>example.com</DomainName>
              <PullDomainName>guide.aliyundoc.com</PullDomainName>
              <PullAppName>livePullApp****</PullAppName>
              <AppName>liveApp****</AppName>
        </LiveLazyPullConfig>
  </LiveLazyPullConfigList>
</DescribeLiveLazyPullStreamConfigResponse>

JSON format

{
    "DescribeLiveLazyPullStreamConfigResponse": {
        "RequestId": "A3136B58-5876-4168-83CA-B562781981A0",
        "LiveLazyPullConfigList": {
            "LiveLazyPullConfig": {
                "PullProtocol": "RTMP",
                "DomainName": "example.com",
                "PullDomainName": "guide.aliyundoc.com",
                "PullAppName": "livePullApp****",
                "AppName": "liveApp****"
            }
        }
    }
}

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.

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.