全部產品
Search

搜尋本產品

    ApsaraVideo VOD：AddTranscodeTemplateGroup

    文件中心

    ApsaraVideo VOD：AddTranscodeTemplateGroup

    更新時間：Jul 21, 2026

    呼叫本介面新增轉碼設定資訊，可建立新的轉碼範本群組，或者向指定範本群組中新增新的轉碼範本。

    介面說明

    • 被影片點播後台鎖定的轉碼範本群組不支援自訂操作，您可以呼叫 GetTranscodeTemplateGroup 介面查詢範本設定，透過返回的回應參數 Locked，檢視範本群組是否被鎖定；您可以呼叫 UpdateTranscodeTemplateGroup 介面將範本解鎖後，再進行變更等操作。

    • 由於轉碼涉及到檔案的儲存位址，因此如果沒有可以正常使用的儲存位址，暫不支援新增轉碼範本群組（您可以在影片點播主控台 > 設定管理 > 媒資管理設定 > 儲存管理中，啟用點播系統 bucket取得可用的儲存位址）。

    • 不轉碼範本群組，不允許追加轉碼範本設定資訊。

    • TranscodeTemplateGroupId 和 Name 必須傳遞一個。

    • 支援最多建立 20 個轉碼範本群組。

    • 一個轉碼範本群組支援最多新增 20 個轉碼範本設定。

    • 若需要透過轉碼產生多碼率自適應串流位址時，一個轉碼範本群組中支援最多新增 10 個影片封裝範本，若超過 10 個，則只會產生各碼流位址，不會產生自適應串流位址。

    QPS 限制

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

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:AddTranscodeTemplateGroup

    create

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Name

    string

    否

    轉碼範本群組名稱。

    • 長度不超過 128 個位元組。

    • UTF-8 編碼。

    說明

    TranscodeTemplateGroupId 和 Name 必須傳遞一個。

    transcodetemplate
    TranscodeTemplateList

    string

    否

    轉碼範本設定資訊（JSON 字串）。參數結構詳情，請參見 TranscodeTemplate 。

    說明

    • 該參數不傳遞，則不會建構轉碼處理流程，影片上傳不會觸發轉碼。

    • 如果不需要設定 Width 或者 Height 屬性，則不傳相應屬性即可，請不要設定為空字串，例如："Height":""。

    [{"Video":{"Bitrate":"400","Codec":"H.264","Fps":"30","Height":360,"Width":640},"Definition":"SD","Container":{"Format":"mp4"},"TemplateName":"testName","MuxConfig":{},"Audio":{"Codec":"AAC","Bitrate":"64","Samplerate":"44100"}}]
    TranscodeTemplateGroupId

    string

    否

    轉碼範本群組 ID。若指定了轉碼範本群組 ID，則可向指定的範本群組中新增新的轉碼範本。

    說明

    TranscodeTemplateGroupId 和 Name 必須傳遞一個。

    4c71a339fe52b4fa6f4527****
    AppId

    string

    否

    應用程式 ID。預設取值：app-1000000。使用說明，請參見多應用。

    app-****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回參數。

    TranscodeTemplateGroupId

    string

    轉碼範本群組 ID。

    34e908aa4024af7821c31f93a2a****
    RequestId

    string

    請求 ID。

    25818875-5F78-4AF6-D7393642CA58****

    樣本

    正常返回樣本

    JSON格式

    {
  "TranscodeTemplateGroupId": "34e908aa4024af7821c31f93a2a****",
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****"
}

    錯誤碼

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

    變更歷史

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