添加直播中心转推配置。
接口说明
本接口的单用户 QPS 限制为 100 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
live:AddLiveCenterTransfer |
create |
*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 | CenterTransfersStreamOverLimit | CenterTransfers stream is over limit for this domainName. | |
| 400 | ConfigAlreadyExists | Config has already exist. | |
| 400 | CodeIllegalDuration | param end_time is before start_time | |
| 500 | InternalError | The request processing has failed due to backend service exception. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。