AddTranscodeTemplateGroup - 建立轉碼模板組 -

介面說明

被ApsaraVideo for VOD後台鎖定的轉碼模板組不支援自訂動作，您可以調用 GetTranscodeTemplateGroup 介面查詢範本配置，通過返回的響應參數 Locked，查看模板組是否被鎖定；您可以調用 UpdateTranscodeTemplateGroup 介面將模板解鎖後，再變更等操作。
由於轉碼涉及到檔案的儲存地址，因此如果沒有可以正常使用的儲存地址，暫不支援添加轉碼模板組（您可以在ApsaraVideo for VOD控制台 > 組態管理 > 媒資管理配置 > 儲存管理中，啟用點播系統 bucket擷取可用的儲存地址）。
不轉碼模板組，不允許追加轉碼模板配置資訊。
TranscodeTemplateGroupId 和 Name 必須傳遞一個。
支援最多建立 20 個轉碼模板組。
一個轉碼模板組支援最多添加 20 個轉碼模板配置。
若需要通過轉碼產生多碼率自適應流地址時，一個轉碼模板組中支援最多添加 10 個視頻打包模板，若超過 10 個，則只會產生各碼流地址，不會產生自適應流地址。

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

vod:AddTranscodeTemplateGroup

create

*全部資源

*

無

名稱	類型	必填	描述	樣本值
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-****

正常返回樣本

JSON格式

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

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

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