重啟任務介面。
介面說明
調用本介面重啟拉流轉推任務。
支援重啟運行中(含異常重試狀態)或已停止的任務,運行中任務會被停止再啟動,未運行中任務會被直接啟動。
任務未到設定的開始時間,重啟無效。
任務重啟會根據任務最新配置執行,會造成推流中斷。
點播類型任務被重啟後,是根據最新播放清單從頭開始播放,使用者可以通過調用更新介面設定視頻索引和視頻播放進度實現續播。
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 服務端錯誤。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。