调用本接口添加转码配置信息，可创建新的转码模板组，或者向指定模板组中添加新的转码模板。
接口说明
- 被视频点播后台锁定的转码模板组不支持自定义操作，您可以调用 GetTranscodeTemplateGroup 接口查询模板配置，通过返回的响应参数 Locked，查看模板组是否被锁定；您可以调用 UpdateTranscodeTemplateGroup 接口将模板解锁后，再进行更改等操作。
- 由于转码涉及到文件的存储地址，因此如果没有可以正常使用的存储地址，暂不支持添加转码模板组（您可以在视频点播控制台 > 配置管理 > 媒资管理配置 > 存储管理中，激活点播系统 bucket获取可用的存储地址）。
- 不转码模板组，不允许追加转码模板配置信息。
- 支持最多创建 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 |
|
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Name | string | 否 | 转码模板组名称。
说明
TranscodeTemplateGroupId 和 Name 必须传递一个。
| transcodetemplate |
| TranscodeTemplateList | string | 否 | 转码模板配置信息（JSON 字符串）。参数结构详情，请参见 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 | 否 | 转码模板组 ID。若指定了转码模板组 ID，则可向指定的模板组中添加新的转码模板。 说明
TranscodeTemplateGroupId 和 Name 必须传递一个。
| 4c71a339fe52b4fa6f4527**** |
| AppId | string | 否 | 应用 ID。默认取值： app-1000000。使用说明，请参见多应用。 | app-**** |
返回参数
示例
正常返回示例
JSON格式
{
"TranscodeTemplateGroupId": "34e908aa4024af7821c31f93a2a****",
"RequestId": "25818875-5F78-4AF6-D7393642CA58****"
}错误码
访问错误中心查看更多错误码。
接口错误码
下表列举了本接口特有的错误码。
| 错误代码 | 错误信息 | HTTP 状态码 | 说明 |
|---|---|---|---|
| InvalidStorage.NotFound | The storage info dose not exist. | 404 | 不存在存储地址数据。 |
| InvalidTranscodeTemplateGroup.NotFound | The transcode template group does not exist. | 404 | 指定的转码模板组不存在。 |
| Forbidden.LockedTemplateGroup | The transcode template group has been locked. | 403 | 指定的模板组被锁定，不可操作，请联系点播后台。 |
| Forbidden.SpecialTemplateGroup | The transcode template group is using for special purpose. | 403 | 特殊用途转码模板组，不允许追加转码模板配置，例如：不转码即分发模板组、仅存储模板组。 |
| TrasncodeTemplateGroupExceededMax | The transcode template group size exceeded maximum. | 400 | 转码模板组数据达到上限，转码模板组最大支持创建 20 个。 |
| TranscodeTemplateExceededMax | The template transcode template config size exceeded maximum. | 400 | 转码模板组关联的转码模板配置数据达到上限，最大支持关联 20 个转码模板配置。 |
| WatermarkExceededMax | The watermark size exceeded maximum. | 400 | 转码模板组下单个转码模板能关联的水印 ID 数达到上限，最大支持关联 4 个水印 ID。 |