全部产品
阿里云办公

添加转码模板组

更新时间:2019-02-14 17:24:35

描述

添加指定的转码模板组。

说明:

  • 被点播后台锁定的转码模板组不支持自定义操作,请联系点播后台。
  • 由于转码涉及到文件的存储地址,因此如果没有存储地址数据,暂不支持添加转码模板组。
  • 不转码即分发转码模板组不允许追加转码模板配置信息。
  • 支持最多创建20个转码模板组。
  • 单个转码模板组支持最多追加20个转码模板配置。

请求参数

参数名称 参数类型 必填项 描述
Action String 接口名称,取值:AddTranscodeTemplateGroup
TranscodeTemplateGroupId String 转码模板组ID
Name String 转码模板组名称
  • 长度不超过128个字节
  • UTF-8编码
TranscodeTemplateList TranscodeTemplate[] 转码模板配置信息(JSON字符串)

说明:

  • TranscodeTemplateList参数不传递,则不会构建转码处理流程,视频上传不会触发转码。
  • TranscodeTemplateGroupId、Name必须传递一个。

返回参数

参数名称 参数类型 描述
RequestId String 请求ID
TranscodeTemplateGroupId String 转码模板数据

API示例

请求示例

  1. https://vod.cn-shanghai.aliyuncs.com?Action=AddTranscodeTemplateGroup&Name=transcodetemplate&TranscodeTemplateList=[{"Video":{"Bitrate":"400","Codec":"H.264","Fps":"30"},"Audio":{"Codec":"AAC","Bitrate":"64","Definition":"SD","EncryptType":"Private","Container":{"Format":"m3u8"},"PackageType":"HLSPackage"}}]

返回示例

JSON格式

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3. "TranscodeTemplateGroupId":"34e908aa4024a9ae4df7821c31f93a2a"
  4. }

错误码

下表列举了本接口特有的错误码。视频点播通用的错误码信息,参见 错误码表

错误代码 错误信息 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. 400 指定的模板组被锁定,不可操作,请联系点播后台。
Forbidden.SpecialTemplateGroup The transcode template group is using for special purpose. 400 特殊用途转码模板组,不允许追加转码模板配置,例如:不转码即分发模板组、仅存储模板组。
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。

SDK示例

建议使用 服务端SDK 来调用API,此API各语言调用的示例代码,请参考如下: