調(diào)用本接口添加轉(zhuǎn)碼配置信息，可創(chuàng)建新的轉(zhuǎn)碼模板組，或者向指定模板組中添加新的轉(zhuǎn)碼模板。
接口說明
- 被視頻點播后臺鎖定的轉(zhuǎn)碼模板組不支持自定義操作，您可以調(diào)用 GetTranscodeTemplateGroup 接口查詢模板配置，通過返回的響應(yīng)參數(shù) Locked，查看模板組是否被鎖定；您可以調(diào)用 UpdateTranscodeTemplateGroup 接口將模板解鎖后，再進行更改等操作。
- 由于轉(zhuǎn)碼涉及到文件的存儲地址，因此如果沒有可以正常使用的存儲地址，暫不支持添加轉(zhuǎn)碼模板組（您可以在視頻點播控制臺 > 配置管理 > 媒資管理配置 > 存儲管理中，激活點播系統(tǒng) bucket獲取可用的存儲地址）。
- 不轉(zhuǎn)碼模板組，不允許追加轉(zhuǎn)碼模板配置信息。
- 支持最多創(chuàng)建 20 個轉(zhuǎn)碼模板組。
- 一個轉(zhuǎn)碼模板組支持最多添加 20 個轉(zhuǎn)碼模板配置。
- 若需要通過轉(zhuǎn)碼生成多碼率自適應(yīng)流地址時，一個轉(zhuǎn)碼模板組中支持最多添加 10 個視頻打包模板 ，若超過 10 個，則只會生成各碼流地址，不會生成自適應(yīng)流地址。
QPS 限制
本接口的單用戶 QPS 限制為 5 次/秒。超過限制，API 調(diào)用會被限流，這可能會影響您的業(yè)務(wù)，請合理調(diào)用。更多信息，請參見 QPS 限制。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀?。≧ead）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| vod:AddTranscodeTemplateGroup | *全部資源 * |
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Name | string | 否 | 轉(zhuǎn)碼模板組名稱。
說明
TranscodeTemplateGroupId 和 Name 必須傳遞一個。
| transcodetemplate |
| TranscodeTemplateList | string | 否 | 轉(zhuǎn)碼模板配置信息（JSON 字符串）。參數(shù)結(jié)構(gòu)詳情，請參見 TranscodeTemplate 。 說明
| [{"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 | 否 | 轉(zhuǎn)碼模板組 ID。若指定了轉(zhuǎn)碼模板組 ID，則可向指定的模板組中添加新的轉(zhuǎn)碼模板。 說明
TranscodeTemplateGroupId 和 Name 必須傳遞一個。
| 4c71a339fe52b4fa6f4527**** |
| AppId | string | 否 | 應(yīng)用 ID。默認(rèn)取值： app-1000000。使用說明，請參見多應(yīng)用。 | app-**** |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"TranscodeTemplateGroupId": "34e908aa4024af7821c31f93a2a****",
"RequestId": "25818875-5F78-4AF6-D7393642CA58****"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
接口錯誤碼
下表列舉了本接口特有的錯誤碼。
| 錯誤代碼 | 錯誤信息 | HTTP 狀態(tài)碼 | 說明 |
|---|---|---|---|
| InvalidStorage.NotFound | The storage info dose not exist. | 404 | 不存在存儲地址數(shù)據(jù)。 |
| InvalidTranscodeTemplateGroup.NotFound | The transcode template group does not exist. | 404 | 指定的轉(zhuǎn)碼模板組不存在。 |
| Forbidden.LockedTemplateGroup | The transcode template group has been locked. | 403 | 指定的模板組被鎖定，不可操作，請聯(lián)系點播后臺。 |
| Forbidden.SpecialTemplateGroup | The transcode template group is using for special purpose. | 403 | 特殊用途轉(zhuǎn)碼模板組，不允許追加轉(zhuǎn)碼模板配置，例如：不轉(zhuǎn)碼即分發(fā)模板組、僅存儲模板組。 |
| TrasncodeTemplateGroupExceededMax | The transcode template group size exceeded maximum. | 400 | 轉(zhuǎn)碼模板組數(shù)據(jù)達到上限，轉(zhuǎn)碼模板組最大支持創(chuàng)建 20 個。 |
| TranscodeTemplateExceededMax | The template transcode template config size exceeded maximum. | 400 | 轉(zhuǎn)碼模板組關(guān)聯(lián)的轉(zhuǎn)碼模板配置數(shù)據(jù)達到上限，最大支持關(guān)聯(lián) 20 個轉(zhuǎn)碼模板配置。 |
| WatermarkExceededMax | The watermark size exceeded maximum. | 400 | 轉(zhuǎn)碼模板組下單個轉(zhuǎn)碼模板能關(guān)聯(lián)的水印 ID 數(shù)達到上限，最大支持關(guān)聯(lián) 4 個水印 ID。 |