调用UpdateLiveCenterTransfer修改直播中心转推配置。
接口说明
本接口仅支持修改转推有效时间(TransferArgs、StartTime、EndTime)相关配置
QPS 限制
本接口的单用户 QPS 限制为 100 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。、
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
live:UpdateLiveCenterTransfer |
update |
*Domain
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
RegionId |
string |
否 |
地域 ID。 |
cn-shanghai |
DomainName |
string |
是 |
播流域名。 |
example.com |
AppName |
string |
是 |
直播流应用名称。输入的 AppName 必须与需要转推的直播流 AppName 保持一致,方可生效。您可在流管理页面查看 AppName。 |
testapp |
StreamName |
string |
是 |
直播流名称。您可在流管理页面查看 StreamName。 |
teststream |
DstUrl |
string |
是 |
转推的第三方直播地址,最多支持添加 1 个地址。 说明
目标地址协议必须和转推的直播流协议一致,目前仅支持 RTMP 和 SRT 协议的转推地址。 |
rtmp://push.example2.aliyunlive.com/testapp1/teststream2 |
TransferArgs |
string |
是 |
转推有效时间。取值:
说明
取值为 time 时,StartTime 和 EndTime 必填。 |
always |
StartTime |
string |
否 |
转推开始时间。 日期格式按照 ISO8601 表示法,并使用 UTC+0 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。 |
2017-12-21T10:00:00Z |
EndTime |
string |
否 |
转推结束时间。日期格式按照 ISO8601 表示法,并使用 UTC+0 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。 说明
结束时间需大于起始时间。 |
2017-12-22T08:00:00Z |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
|||
RequestId |
string |
请求 ID。 |
7908F2FF-44F8-120F-9FD6-85AE4B6C19EC |
示例
正常返回示例
JSON
格式
{
"RequestId": "7908F2FF-44F8-120F-9FD6-85AE4B6C19EC"
}
错误码
HTTP status code |
错误码 |
错误信息 |
描述 |
---|---|---|---|
400 | InvalidParam | Parameter invalid. | 输入参数不合法 |
400 | CodeIllegalDuration | param end_time is before start_time | |
500 | InternalError | The request processing has failed due to backend service exception. |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。