全部產品
Search

搜尋本產品

    ApsaraVideo Live：UpdateLivePullToPush

    文件中心

    ApsaraVideo Live：UpdateLivePullToPush

    更新時間：Jun 23, 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

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    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-shenzhen :

      深圳。

    • cn-qingdao :

      青島。

    • preregion :

      預發。

    • cn-beijing :

      北京。

    • cn-shanghai :

      上海。

    • ap-southeast-1 :

      新加坡。

    • eu-central-1 :

      德國-法蘭克福。

    • ap-northeast-1 :

      日本-東京。

    • ap-southeast-5 :

      印度尼西亞。

    • me-central-1 :

      沙烏地-利雅德。

    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 類型填寫阿里雲影片點播媒資 ID。

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

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

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

    changedtesturl

    string

    否

    源流 URL 位址。

    說明

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

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

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

    • 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.
    400 CodeTaskNotExist Task does not exist.
    400 CodeTaskHasStarted The task has already started.
    500 InternalError %s.

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

    變更歷史

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