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.
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
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:
|
PullProtocol | String | Yes | rtmp | The protocol for back-to-origin stream pulling. Valid values:
|
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. |