All Products
Search
Document Center

ApsaraVideo Live:SetLiveLazyPullStreamInfoConfig

Last Updated:Nov 07, 2023

Creates a configuration of triggered stream pulling.

Usage notes

You can call this operation to configure triggered stream pulling. ApsaraVideo Live automatically pulls live streams from the origin server when the origin server starts to play live streams.

Note The IPv6 protocol is not supported.

QPS limit

You can call this operation up to 1,000 times per minute 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

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 SetLiveLazyPullStreamInfoConfig

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

DomainName String Yes example.com

The name of the main streaming domain.

AppName String Yes ali_all_app

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

Note To allow triggered stream pulling for all applications, set the value to ali_all_app.
PullDomainName String Yes guide.aliyundoc.com

The origin server address of the live stream. Separate multiple origin server addresses with semicolons (;).

PullAppName String No livePullApp****

The name of the application for back-to-origin stream pulling.

Note To use the application specified in the streaming URL, leave this parameter empty.
TranscodeLazy String No no

Specifies whether to trigger stream pulling when the transcoded stream is played. Default value: no. Valid values:

  • yes
  • no
PullProtocol String Yes rtmp

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

  • rtmp
  • httpflv
  • hls

Response parameters

Parameter

Type

Example

Description

RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CF8

The ID of the request.

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=SetLiveLazyPullStreamInfoConfig
&DomainName=example.com
&AppName=ali_all_app
&PullDomainName=guide.aliyundoc.com
&PullAppName=livePullApp****
&TranscodeLazy=no
&PullProtocol=rtmp
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<SetLiveLazyPullStreamInfoResponse>
    <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CF8</RequestId>
</SetLiveLazyPullStreamInfoResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "SetLiveLazyPullStreamInfoResponse" : {
    "RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CF8"
  }
}

Error codes

For a list of error codes, see Service error codes.

Error code

Error message

HTTP status code

Description

InvalidDomain.NotFound

The domain provided does not exist in our records.

404

The domain name does not belong to your Alibaba Cloud account.

IllegalOperation

Illegal domain operate is not permitted.

403

The current operation is not supported. For example, the specified domain name is not a live domain.

Missing DomainName

DomainName is mandatory for this action.

400

A required parameter is not specified.

InternalError

The request processing has failed due to some unknown error.

500

An unknown error has occurred.