重启任务接口。
接口说明
调用本接口重启拉流转推任务。
支持重启运行中（含异常重试状态）或已停止的任务，运行中任务会被停止再启动，未运行中任务会被直接启动。
任务未到设置的开始时间，重启无效。
任务重启会根据任务最新配置执行，会造成推流中断。
点播类型任务被重启后，是根据最新播放列表从头开始播放，用户可以通过调用更新接口设置视频索引和视频播放进度实现续播。
QPS 限制
本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
live:RestartLivePullToPush |
update |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
否 |
地域 ID。 |
cn-shanghai |
| Region |
string |
是 |
指定直播中心查询。取值：
|
preregion |
| TaskId |
string |
是 |
根据任务 ID 查询。 |
6f869419-0692-4fd5-8cf0-66cab659**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 id |
a05e6b15-15af-405b-a4a2-01522450**** |
| TaskId |
string |
新建任务 id。 |
fb0d4ac7-c7e3-4978-9743-0bf2f6e8**** |
示例
正常返回示例
JSON格式
{
"RequestId": "a05e6b15-15af-405b-a4a2-01522450****",
"TaskId": "fb0d4ac7-c7e3-4978-9743-0bf2f6e8****"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParameter | %s. | 参数错误 |
| 400 | LiveServiceNotFound | Your account does not open Live service yet | 您的账户尚未开通直播服务 |
| 400 | InvalidParam.CodeIllegalDuration | %s. | 开始时间应该小于结束时间。 |
| 400 | CodeInvalidAliUid | This aliuid does not have a live domain name. | 这个aluid没有直播域名 |
| 400 | CodeTaskNotExist | Task does not exist. | 任务不存在。 |
| 500 | InternalError | %s. | 直播 liveapi 服务端错误。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。