全部產品
Search

搜尋本產品

    ApsaraVideo Live：UpdateLivePullToPush - 更新拉流轉推任務

    文件中心

    ApsaraVideo Live：UpdateLivePullToPush - 更新拉流轉推任務

    更新時間：Mar 25, 2026

    調用UpdateLivePullToPush更新拉流轉推任務。

    介面說明

    • 調用本介面更新拉流轉推任務。

    • 任務未到設定的開始時間，支援更新 Region。

    • 任務運行中（含異常重試狀態）僅支援更新 CallbackUrl 和 RepeatTime 且更新會立即生效。

    • 任務已停止，除 Region，其他參數均允許更新。

    QPS 限制

    本介面的單使用者 QPS 限制為 10 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    live:UpdateLivePullToPush

    update

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    否

    地區 ID。

    cn-beijing
    TaskId

    string

    是

    任務 ID。

    fd245384-4067-4f91-9d75-9666a6bc****
    Region

    string

    是

    指定任務啟動所在地區，取值：

    • ap-southeast-1（新加坡）

    • ap-southeast-5（印尼）

    • cn-beijing（北京）

    • cn-shanghai（上海）

    cn-shanghai
    StartTime

    string

    否

    任務開始時間。

    說明

    • 格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    • 若任務已經啟動運行則更新無效。

    2024-08-23T15:30:00Z
    EndTime

    string

    否

    任務結束時間。

    說明

    • 格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    • EndTime 必須大於 StartTime。

    • EndTime 必須大於目前時間。

    • 若任務已結束退出則更新無效。

    2024-08-27T14:30:00Z
    SourceUrls

    array

    否

    源流 URL 地址清單。

    說明

    • live 類型僅支援填寫 1 個完整直播播放 URL。

    • vod、url 類型可填寫最多 30 個。

    • live 類型支援：rtmp、srt、http-flv 協議。

    • vod 類型填寫阿里雲ApsaraVideo for VOD媒資 ID。

    • url 類型支援：mp4、http-flv 協議。

    • 針對直播源流可立即生效；針對視頻檔案源流，需要等當前現正播放視頻結束後生效，生效後基於最新視頻列表從頭開始播放。

    • 需要在任務停止啟動並執行狀態下更新，重啟後生效。

    changedtesturl

    string

    否

    源流 URL 地址。

    說明

    • live 類型僅支援填寫 1 個完整直播播放 URL。

    • vod、url 類型可填寫最多 30 個。

    • live 類型支援：rtmp、srt、http-flv 協議。

    • vod 類型填寫阿里雲ApsaraVideo for VOD媒資 ID。

    • url 類型支援：mp4、http-flv 協議。

    • 針對直播源流可立即生效；針對視頻檔案源流，需要等當前現正播放視頻結束後生效，生效後基於最新視頻列表從頭開始播放。

    • 需要在任務停止啟動並執行狀態下更新，重啟後生效。

    rtmp://pulltest.****.aliyunlive.com/pulltest493/pulltest-w434
    RepeatNumber

    integer

    否

    播放完後重複繼續播放的次數。取值：

    • 0（預設值）：不重複播放。

    • -1：一直迴圈重複。

    • 其他正整數：播放完後重複繼續播放的次數。

    說明

    • 此參數僅針對點播或第三方視頻流。

    • 更新後可以立即生效。

    0
    Offset

    integer

    否

    啟動位移，視頻檔案起始位移值。單位：秒。取值：大於 0。

    說明

    • 表示從相對於首幀的偏差時間作為開始讀取的位置。

    • 此參數僅針對點播或第三方視頻流。

    • 僅當播放視頻列表第一個視頻時有效。

    • 需要在任務停止啟動並執行狀態下更新，重啟後生效。

    2
    CallbackUrl

    string

    否

    回調地址，預設為空白。

    說明

    • 接收任務相關回調的地址。

    • 最大長度為 2000 個字元。

    • 不指定本參數則不會回調相關任務事件。

    • 僅當下一次事件觸發時開始生效。

    https://callback*****.com
    FileIndex

    integer

    否

    視頻索引，預設值為 0。

    說明

    需要在任務停止啟動並執行狀態下更新，重啟後生效。

    0

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID。

    16A96B9A-F203-4EC5-8E43-CB92E68*****
    RetCode

    integer

    返回碼。

    說明

    • 正常情況返回“0”。

    • 異常情況請參考下文錯誤碼列表。

    0
    Description

    string

    錯誤描述。

    OK

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68*****",
  "RetCode": 0,
  "Description": "OK"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 InvalidParameter %s. 參數錯誤
    400 InvalidParam.CodeIllegalDuration %s. 開始時間應該小於結束時間。
    400 CodeInvalidAliUid This aliuid does not have a live domain name. 這個aluid沒有直播網域名稱
    400 CodeTaskNotExist Task does not exist. 任務不存在。
    400 CodeTaskHasStarted The task has already started. 任務已經啟動，無法更新。
    500 InternalError %s. 直播 liveapi 服務端錯誤。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。