调用SetLiveLazyPullStreamInfoConfig添加拉流信息。

使用说明

本接口的拉流方式属于触发拉流，即当需要拉取的源站开始播放直播流时，自动触发阿里云视频直播服务进行拉流直播。

说明 本接口暂时不支持IPv6协议。

QPS限制

本接口的单用户QPS限制为1000次/分钟。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 SetLiveLazyPullStreamInfoConfig

系统规定参数。取值：SetLiveLazyPullStreamInfoConfig。

DomainName String 是 example.com

主播流域名。
AppName String 是 ali_all_app

播流所属应用名称。

说明 如果需要全部App都触发回源，则取值ali_all_app。
PullDomainName String 是 guide.aliyundoc.com

直播流所在的源站。多个源站使用英文分号（;）分隔。
PullAppName String 否 livePullApp****

回源拉流App。

说明 如果使用播放URL中的App，则此参数为空。
PullProtocol String 是 rtmp

回源拉流协议。取值：

  • rtmp
  • httpflv
  • hls

返回数据

名称 类型 示例值 描述
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CF8

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=SetLiveLazyPullStreamInfoConfig
&AppName=ali_all_app
&DomainName=example.com
&PullDomainName=guide.aliyundoc.com
&PullProtocol=rtmp
&<公共请求参数>

正常返回示例

XML格式 

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格式 

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

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

错误码

访问错误中心查看更多错误码。

错误代码

描述

HTTP 状态码

语义

InvalidDomain.NotFound

The domain provided does not exist in our records.

404

当前账户下未查到域名

IllegalOperation

Illegal domain operate is not permitted.

403

不支持当前操作，如：非直播类域名

Missing DomainName

DomainName is mandatory for this action.

400

缺少参数

InternalError

The request processing has failed due to some unknown error.

500

后台发生未知错误