调用AddTranscodeTemplateGroup添加转码配置信息,可创建新的转码模板组,或者向指定模板组中添加新的转码模板。
接口说明
- 被视频点播后台锁定的转码模板组不支持自定义操作,请提交工单联系阿里云技术支持处理。
- 由于转码涉及到文件的存储地址,因此如果没有存储地址数据,暂不支持添加转码模板组(储地址数据在存储管理里面激活)。
- 不转码模板组,不允许追加转码模板配置信息。
- 支持最多创建20个转码模板组。
- 一个转码模板组支持最多追加20个转码模板配置。
- 若需要通过转码生成多码率自适应流地址时,一个转码模板组中支持最多添加10个视频打包模板 ,若超过10个,则只会生成各码流地址,不会生成自适应流地址。
QPS限制
本接口的单用户QPS限制为5次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Name | string | 否 | 转码模板组名称。
说明TranscodeTemplateGroupId和Name必须传递一个。 | transcodetemplate |
TranscodeTemplateList | string | 否 | 转码模板配置信息(JSON字符串)。参数结构详情,请参见TranscodeTemplate。 说明该参数不传递,则不会构建转码处理流程,视频上传不会触发转码。 | [{"Video":{"Bitrate":"400","Codec":"H.264","Fps":"30","Height":""},"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-**** |
返回参数
示例
请求示例
https://vod.{ApiRegion}.aliyuncs.com/?Action=AddTranscodeTemplateGroup
&Name=transcodetemplate
&TranscodeTemplateList=[{"Video":{"Bitrate":"400","Codec":"H.264","Fps":"30","Height":""},"Definition":"SD","Container":{"Format":"mp4"},"TemplateName":"testName","MuxConfig":{},"Audio":{"Codec":"AAC","Bitrate":"64","Samplerate":"44100"}}]
&TranscodeTemplateGroupId=4c71a339fe*****52b4fa6f4527
&AppId=app-****
&<公共请求参数>
正常返回示例
JSON
格式
{
"RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
"TranscodeTemplateGroupId":"34e908aa4024a*****f7821c31f93a2a"
}
XML
格式
<AddTranscodeTemplateGroupResponse>
<RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
<TranscodeTemplateGroupId>34e908aa4024a*****f7821c31f93a2a</TranscodeTemplateGroupId>
</AddTranscodeTemplateGroupResponse>
错误码
访问错误中心查看更多错误码。
接口错误码
下表列举了本接口特有的错误码。
错误代码 | 错误信息 | 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。 |