GetTranscodeTemplateGroup查询转码模板组配置详情-视频点播-阿里云-视频点播(VOD)-阿里云帮助中心

根据转码模板组ID查询转码配置的详细信息。

接口说明

获取单个模板组信息，同时会返回该模板组下所有转码模板的配置信息。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

vod:GetTranscodeTemplateGroup

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
TranscodeTemplateGroupId	string	是	转码模板组 ID。	a591f697c7167*****6ae1502142d0

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	6730AC93-7B12-4B*****7F-49EE1FE8BC49
TranscodeTemplateGroup	object	转码模板组数据。
CreationTime	string	模板组的创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2018-12-12T10:20:51Z
IsDefault	string	是否是默认模板组。取值： Default：默认模板组。 NotDefault：非默认模板组。	NotDefault
AppId	string	应用 ID。	app-****
TranscodeTemplateGroupId	string	转码模板组 ID。	a59b11f697c716*****6ae1502142d0
Name	string	模板组的名称。	test
ModifyTime	string	模板组的修改时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2018-12-12T11:20:51Z
Locked	string	模板组是否处于锁定状态。取值： Disabled：未锁定 Enabled：锁定	Enabled
TranscodeTemplateList	array<object>	转码模板配置信息列表。
	object
Type	string	模板类型，取值： Normal（默认）：正常转码模板。该类型模板不能设置 PackageSetting 参数。 VideoPackage：视频流打包模板。该类型模板会先转码，后构建自适应码流，且必须要配置 PackageSetting 参数。 SubtitlePackage：字幕打包模板。该类型模板不会转码，仅将对应字幕信息构建到自适应码率输出文件中，且必须要设置 PackageSetting 参数。但该类型模板不能在模板组中单独存在，需要与 VideoPackage 类型模板一同配置（一个模板组仅能配置一个该类型模板）。	Normal
Video	string	视频流转码配置参数（JSON 字符串）。	{"Codec":"H.264","Bitrate":"900","Width":"960","Remove":"false","Fps":"30"}
TransConfig	string	条件转码参数。如需要根据源片码率、分辨率进行基本逻辑判断再输出转码视频，则可设置该参数（JSON 字符串）。	{"IsCheckReso":"true","IsCheckResoFail":"false","IsCheckVideoBitrate":"false","IsCheckVideoBitrateFail":"false","IsCheckAudioBitrate":"false","IsCheckAudioBitrateFail":"false"}
Rotate	string	视频旋转标参数。控制画面的旋转角度，例如：设置 180，则视频画面将上下颠倒。取值范围：`[0,360]`。	90
TranscodeTemplateId	string	转码模板 ID。	696d29a11erc057*****a3acc398d02f4
TemplateName	string	转码模板名称。	test
EncryptSetting	string	转码加密配置信息。	"EncryptType":"Private"
Audio	string	音频流转码配置参数（JSON 字符串）。	{"Codec":"AAC","Remove":"false","Bitrate":"44","Samplerate":"32000","Channels":"2","Profile":"aac_low"}
TranscodeFileRegular	string	自定义转码输出路径。	{MediaId}/transcoce_1
Container	string	封装音视频码流的容器格式（JSON 字符串）。	"Format":"m3u8"
Clip	string	视频裁剪配置（JSON 字符串）。例如：需要截取视频中的 5s 内容，用于生成一个新的视频，则可设置该参数。	{"TimeSpan":{"Seek":"1","Duration":"5"}
Definition	string	普通转码模板清晰度标记： LD（流畅） SD（标清） HD（高清） FHD（超清） OD（原画，即转封装） 2K 4K SQ（普通音质） HQ（高音质）窄带高清 1.0 内置转码模板清晰度标记： LD-NBV1（流畅） SD-NBV1（标清） HD-NBV1（高清） FHD-NBV1（超清） 2K-NBV1 4K-NBV1 说明所有转码模板不支持清晰度标记修改。窄带高清 1.0 转码模板音视频分辨率、码率等参数为系统内置，不支持修改。窄带高清 1.0 转码模板创建只支持 FLV、M3U8(HLS)、MP4 格式。	SD
PackageSetting	string	打包配置。仅支持 HLS 自适应码流打包、DASH 打包（JSON 字符串）。	"PackageType":"HLSPackage","PackageConfig":{ "BandWidth":"900000" }
SubtitleList	string	字幕配置（JSON 字符串）。	[{"SubtitleUrl":"http://outin-test.oss-cn-shanghai.aliyuncs.com/subtitles/c737fece-14f1-4364-b107-d5f7f8edde0e.ass","CharEncode":"utf-8"}]
MuxConfig	string	转码的分片设置参数。HLS 必传（JSON 字符串）。	"Segment": { "Duration":"6" }
WatermarkIds	array	关联的图文水印模板 ID。
	string	关联的图文水印模板 ID。	"USER_DEFAULT_WATERMARK","ddddddddd"
TraceMark	string	溯源水印信息。	{ "Enable": true }
CopyrightMark	string	版权水印信息。	{ "Content": "Test copyright watermark text" }

示例

正常返回示例

JSON格式

{
  "RequestId": "6730AC93-7B12-4B*****7F-49EE1FE8BC49",
  "TranscodeTemplateGroup": {
    "CreationTime": "2018-12-12T10:20:51Z",
    "IsDefault": "NotDefault",
    "AppId": "app-****",
    "TranscodeTemplateGroupId": "a59b11f697c716*****6ae1502142d0",
    "Name": "test",
    "ModifyTime": "2018-12-12T11:20:51Z",
    "Locked": "Enabled",
    "TranscodeTemplateList": [
      {
        "Type": "Normal",
        "Video": "{\"Codec\":\"H.264\",\"Bitrate\":\"900\",\"Width\":\"960\",\"Remove\":\"false\",\"Fps\":\"30\"}",
        "TransConfig": "{\"IsCheckReso\":\"true\",\"IsCheckResoFail\":\"false\",\"IsCheckVideoBitrate\":\"false\",\"IsCheckVideoBitrateFail\":\"false\",\"IsCheckAudioBitrate\":\"false\",\"IsCheckAudioBitrateFail\":\"false\"}",
        "Rotate": "90",
        "TranscodeTemplateId": "696d29a11erc057*****a3acc398d02f4",
        "TemplateName": "test",
        "EncryptSetting": "\"EncryptType\":\"Private\"",
        "Audio": "{\"Codec\":\"AAC\",\"Remove\":\"false\",\"Bitrate\":\"44\",\"Samplerate\":\"32000\",\"Channels\":\"2\",\"Profile\":\"aac_low\"}",
        "TranscodeFileRegular": "{MediaId}/transcoce_1",
        "Container": "\"Format\":\"m3u8\"",
        "Clip": "{\"TimeSpan\":{\"Seek\":\"1\",\"Duration\":\"5\"}",
        "Definition": "SD",
        "PackageSetting": "\"PackageType\":\"HLSPackage\",\"PackageConfig\":{   \"BandWidth\":\"900000\"  }",
        "SubtitleList": "[{\"SubtitleUrl\":\"http://outin-test.oss-cn-shanghai.aliyuncs.com/subtitles/c737fece-14f1-4364-b107-d5f7f8edde0e.ass\",\"CharEncode\":\"utf-8\"}]",
        "MuxConfig": "\"Segment\": { \"Duration\":\"6\" }",
        "WatermarkIds": [
          "\"USER_DEFAULT_WATERMARK\",\"ddddddddd\""
        ],
        "TraceMark": "{\n\t\"Enable\": true\n}",
        "CopyrightMark": "{\n\"Content\": \"Test copyright watermark text\"\n}"
      }
    ]
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。