SetLiveLazyPullStreamInfoConfig - ApsaraVideo Live

Usage notes

You can call this operation to configure triggered stream pulling. The configuration lets ApsaraVideo Live automatically pull 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 main streaming domain.
AppName	String	Yes	ali_all_app	The name of the application to which the live stream belongs. Note If you want to configure 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 addresses with semicolons (;).
PullAppName	String	No	livePullApp****	The name of the application for back-to-origin stream pulling. Note If you want 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 request ID.

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

<SetLiveLazyPullStreamInfoConfigResponse>
    <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CF8</RequestId>
</SetLiveLazyPullStreamInfoConfigResponse>

JSON format

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

{
  "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 is not found within your Alibaba Cloud account.
IllegalOperation	Illegal domain operate is not permitted.	403	The current operation is not supported because, for example, the specified domain name is not a domain name in ApsaraVideo Live.
Missing DomainName	DomainName is mandatory for this action.	400	One or more required parameters are not specified.
InternalError	The request processing has failed due to some unknown error.	500	An unknown error occurred.