调用SetLiveLazyPullStreamInfoConfig添加拉流信息。
使用说明
本接口的拉流方式属于触发拉流,即当需要拉取的源站开始播放直播流时,自动触发阿里云视频直播服务进行拉流直播。
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,则此参数为空。 |
TranscodeLazy | String | 否 | no | 转码播放触发拉流。默认为no。可选值:
|
PullProtocol | String | 是 | rtmp | 回源拉流协议。取值:
|
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CF8 | 请求ID。 |
示例
请求示例
http(s)://live.aliyuncs.com/?Action=SetLiveLazyPullStreamInfoConfig
&DomainName=example.com
&AppName=ali_all_app
&PullDomainName=guide.aliyundoc.com
&PullAppName=livePullApp****
&TranscodeLazy=no
&PullProtocol=rtmp
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<SetLiveLazyPullStreamInfoConfigResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CF8</RequestId>
</SetLiveLazyPullStreamInfoConfigResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"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 |
后台发生未知错误 |