Queries the configurations of triggered stream pulling for a streaming domain.
Usage notes
This operation is applicable to regular stream pulling. You can call this operation to query the configurations of regular stream pulling for a domain name.
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 | DescribeLiveLazyPullStreamConfig | The operation that you want to perform. Set the value to DescribeLiveLazyPullStreamConfig. |
DomainName | String | Yes | example.com | The name of 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 |
RequestId | String | A3136B58-5876-4168-83CA-B562781981A0 | The request ID. |
LiveLazyPullConfigList | Array of LiveLazyPullConfig | The stream pulling configurations. |
|
LiveLazyPullConfig | |||
AppName | String | liveApp**** | The name of the application. |
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. |
PullProtocol | String | RTMP | The protocol for back-to-origin stream pulling. Valid values:
|
PullDomainName | String | guide.aliyundoc.com | The domain name for back-to-origin stream pulling. |
DomainName | String | example.com | The name of the main streaming domain. |
TranscodeLazy | String | no | Indicates whether stream pulling is triggered when the transcoded stream is played. By default, no is returned. Valid values:
|
Examples
Sample requests
http(s)://live.aliyuncs.com/?Action=DescribeLiveLazyPullStreamConfig
&DomainName=example.com
&<Common request parameters>
Sample success responses
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeLiveLazyPullStreamConfigResponse>
<RequestId>A3136B58-5876-4168-83CA-B562781981A0</RequestId>
<LiveLazyPullConfigList>
<AppName>liveApp****</AppName>
<PullAppName>livePullApp****</PullAppName>
<PullProtocol>RTMP</PullProtocol>
<PullDomainName>guide.aliyundoc.com</PullDomainName>
<DomainName>example.com</DomainName>
<TranscodeLazy>no</TranscodeLazy>
</LiveLazyPullConfigList>
</DescribeLiveLazyPullStreamConfigResponse>
JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "A3136B58-5876-4168-83CA-B562781981A0",
"LiveLazyPullConfigList" : [ {
"AppName" : "liveApp****",
"PullAppName" : "livePullApp****",
"PullProtocol" : "RTMP",
"PullDomainName" : "guide.aliyundoc.com",
"DomainName" : "example.com",
"TranscodeLazy" : "no"
} ]
}
Error codes
For a list of error codes, see Service error codes.
Special error codes
Error code |
Error message |
HTTP status code |
Description |
Missing DomainName |
DomainName is mandatory for this action. |
400 |
One or more required parameters are not specified. |
InvalidDomain.NotFound |
The domain provided does not exist in our records. |
404 |
The domain name is not found within your Alibaba Cloud account. |