文档首页/ 视频点播 VOD/ API参考/ 转码模板集合管理/ 创建转码模板组集合 - CreateTemplateGroupCollection
更新时间：2025-10-29 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建转码模板组集合 - CreateTemplateGroupCollection

功能介绍

创建转码模板组集合。

接口约束

  • 不同模板的转码产物类型完全一样时，不支持添加至同一个转码模板组中。

  • 相同编码格式的模板，在转码模板组的产物类型，不允许同时出现HLS/DASH（二选一）和HLS_DASH。不同编码格式的模板无影响。

其中codec为视频编码格式，取值为H.264或H.265，详见查询媒资信息。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1.0/{project_id}/asset/template-collection/transcodings

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方法请参考获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

用户Token，使用Token鉴权方式时必选。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

Authorization

否

String

使用AK/SK方式认证时必选，携带的鉴权信息。

X-Sdk-Date

否

String

使用AK/SK方式认证时必选，请求的发生时间。
表3 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

模板组集合名称

description

否

String

模板组集合描述

template_group_list

是

Array of strings

模板组列表，模板ID

响应参数

状态码：201

表4 响应Body参数

参数

参数类型

描述

group_collection_id

String

模板组集合ID

状态码：400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

创建转码模板集合

POST https://{endpoint}/v1.0/{project_id}/asset/template-collection/transcodings

Content-Type: application/json
{
  "name": "test",
  "template_group_list": [
    "780640dd1d584a6999b104568c358b78",
    "6a16d8d0161c42caa42b9c148d032871"
  ]
}

响应示例

状态码：201

处理成功返回。

{
  "group_collection_id" : "f9b045e0811c482f9de0d436a5927bb6"
}

状态码：400

处理失败返回。

{
  "error_code" : "VOD.10053",
  "error_msg" : "The request parameter is illegal, illegal field: {xx}."
}

状态码

状态码

描述

201

处理成功返回。

400

处理失败返回。

错误码

请参见错误码。