调用UpdateLiveCenterTransfer修改直播中心转推配置。
接口说明
本接口仅支持修改转推有效时间(TransferArgs,StartTime,EndTime)相关配置
QPS限制
本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | UpdateLiveCenterTransfer | 系统规定参数。取值:UpdateLiveCenterTransfer。 |
DomainName | String | 是 | example.com | 播流域名。 |
AppName | String | 是 | testapp | 直播流应用名称。输入的AppName必须与需要转推的直播流AppName保持一致,方可生效。 |
StreamName | String | 是 | teststream | 直播流名称。 |
DstUrl | String | 是 | rtmp://push.example2.aliyunlive.com/testapp1/teststream2 | 转推的第三方直播地址,最多支持添加1个地址。 说明 目标地址协议必须和转推的直播流协议一致,目前仅支持RTMP和SRT协议的转推地址。 |
TransferArgs | String | 是 | always | 转推有效时间。取值:
说明 取值为time时,StartTime和EndTime必填。 |
StartTime | String | 否 | 2017-12-21T10:00:00Z | 转推开始时间。 日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。 |
EndTime | String | 否 | 2017-12-22T08:00:00Z | 转推结束时间。日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。 说明 结束时间需大于起始时间。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | 7908F2FF-44F8-120F-9FD6-85AE4B6C19EC | 请求ID。 |
示例
请求示例
http(s)://live.aliyuncs.com/?Action=UpdateLiveCenterTransfer
&DomainName=example.com
&AppName=testapp
&StreamName=teststream
&DstUrl=rtmp://push.example2.aliyunlive.com/testapp1/teststream2
&TransferArgs=always
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateLiveCenterTransferResponse>
<RequestId>7908F2FF-44F8-120F-9FD6-85AE4B6C19EC</RequestId>
</UpdateLiveCenterTransferResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "7908F2FF-44F8-120F-9FD6-85AE4B6C19EC"
}
错误码
访问错误中心查看更多错误码。