DescribeLiveLazyPullStreamConfig - ApsaraVideo Live - Alibaba Cloud Documentation Center

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