AddTranscodeTemplateGroup - 创建转码模板组

调用AddTranscodeTemplateGroup添加转码配置信息,可创建新的转码模板组,或者向指定模板组中添加新的转码模板。

接口说明

  • 被视频点播后台锁定的转码模板组不支持自定义操作,请提交工单联系阿里云技术支持处理。
  • 由于转码涉及到文件的存储地址,因此如果没有存储地址数据,暂不支持添加转码模板组(储地址数据在存储管理里面激活)。
  • 不转码模板组,不允许追加转码模板配置信息。
  • 支持最多创建20个转码模板组。
  • 一个转码模板组支持最多追加20个转码模板配置。
  • 若需要通过转码生成多码率自适应流地址时,一个转码模板组中支持最多添加10个视频打包模板 ,若超过10个,则只会生成各码流地址,不会生成自适应流地址。

QPS限制

本接口的单用户QPS限制为5次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
Namestring

转码模板组名称。

  • 长度不超过128个字节。
  • UTF-8编码。
说明TranscodeTemplateGroupId和Name必须传递一个。
transcodetemplate
TranscodeTemplateListstring

转码模板配置信息(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"}}]
TranscodeTemplateGroupIdstring

转码模板组ID。若指定了转码模板组ID,则可向指定的模板组中添加新的转码模板。

说明TranscodeTemplateGroupId和Name必须传递一个。
4c71a339fe52b4fa6f4527****
AppIdstring

应用ID。默认取值: app-1000000。使用说明,请参见多应用

app-****

返回参数

名称类型描述示例值
object

返回参数。

TranscodeTemplateGroupIdstring

转码模板组ID。

34e908aa4024af7821c31f93a2a****
RequestIdstring

请求ID。

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

示例

请求示例

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.NotFoundThe storage info dose not exist.404不存在存储地址数据。
InvalidTranscodeTemplateGroup.NotFoundThe transcode template group does not exist.404指定的转码模板组不存在。
Forbidden.LockedTemplateGroupThe transcode template group has been locked.403指定的模板组被锁定,不可操作,请联系点播后台。
Forbidden.SpecialTemplateGroupThe transcode template group is using for special purpose.403特殊用途转码模板组,不允许追加转码模板配置,例如:不转码即分发模板组、仅存储模板组。
TrasncodeTemplateGroupExceededMaxThe transcode template group size exceeded maximum.400转码模板组数据达到上限,转码模板组最大支持创建20个。
TranscodeTemplateExceededMaxThe template transcode template config size exceeded maximum.400转码模板组关联的转码模板配置数据达到上限,最大支持关联20个转码模板配置。
WatermarkExceededMaxThe watermark size exceeded maximum.400转码模板组下单个转码模板能关联的水印ID数达到上限,最大支持关联4个水印ID。
阿里云首页 视频点播 相关技术圈