视频点播
| 产品详情
  • 媒资上传
    • 上传检验CheckMd5Duplication
    • 确认媒资上传ConfirmAssetUpload
    • 创建媒资:上传方式CreateAssetByFileUpload
    • 创建媒资:OBS托管方式CreateTakeOverTask
    • 创建媒资:OBS转存方式PublishAssetFromObs
    • 获取分段上传授权ShowAssetTempAuthority
    • 桶授权UpdateBucketAuthorized
    • 创建媒资:URL拉取注入UploadMetaDataByUrl
  • 媒资处理
    • 取消媒资转码任务CancelAssetTranscodeTask
    • 取消提取音频任务CancelExtractAudioTask
    • 媒资处理CreateAssetProcessTask
    • 创建审核媒资任务CreateAssetReviewTask
    • 音频提取CreateExtractAudioTask
    • 视频更新UpdateAsset
    • 设置封面UpdateCoverByThumbnail
  • 媒资管理
    • 删除媒资DeleteAssets
    • 查询媒资列表ListAssetList
    • 媒资发布PublishAssets
    • 查询指定媒资的详细信息ShowAssetDetail
    • 查询媒资信息ShowAssetMeta
    • 媒资发布取消UnpublishAssets
    • 修改媒资属性UpdateAssetMeta
  • OBS托管管理
    • 查询托管任务ListTakeOverTask
    • 查询托管媒资详情ShowTakeOverAssetDetails
    • 查询托管任务详情ShowTakeOverTaskDetails
  • 媒资预热
    • CDN预热CreatePreheatingAsset
    • 查询CDN预热ShowPreheatingAsset
  • 媒资分类
    • 创建媒资分类CreateAssetCategory
    • 删除媒资分类DeleteAssetCategory
    • 查询指定分类信息ListAssetCategory
    • 修改媒资分类UpdateAssetCategory
  • 密钥查询
    • 密钥查询ShowAssetCipher
  • 统计分析
    • 查询媒资日播放统计数据ListAssetDailySummaryLog
    • 查询域名播放日志ListDomainLogs
    • 查询TopN媒资信息ListTopStatistics
    • 查询CDN统计信息ShowCdnStatistics
    • 查询源站统计信息ShowVodStatistics
  • 转码模板组管理
    • 创建自定义转码模板组CreateTemplateGroup
    • 删除自定义转码模板组DeleteTemplateGroup
    • 查询转码模板组列表ListTemplateGroup
    • 修改自定义转码模板组UpdateTemplateGroup
  • 水印模板管理
    • 确认水印图片上传ConfirmImageUpload
    • 创建水印模板CreateWatermarkTemplate
    • 删除水印模板DeleteWatermarkTemplate
    • 查询水印列表ListWatermarkTemplate
    • 修改水印模板UpdateWatermarkTemplate
  • 媒资存储模式管理
    • 查询媒资降冷配置ShowStorageModeType
    • 查询取回数据信息ShowVodRetrieval
    • 修改媒资文件在obs的存储模式UpdateStorageMode
    • 修改媒资降冷粒度UpdateStorageModeType
  • 转码产物管理
    • 删除转码产物DeleteTranscodeProduct
  • 转码模板管理
    • 创建自定义转码模板CreateTranscodeTemplate
    • 删除自定义模板DeleteTranscodeTemplate
    • 查询转码模板列表ListTranscodeTemplate
    • 修改转码模板UpdateTranscodeTemplate
  • 转码模板集合管理
    • 创建转码模板组集合CreateTemplateGroupCollection
    • 删除转码模板组集合DeleteTemplateGroupCollection
    • 查询自定义模板组集合ListTemplateGroupCollection
    • 修改转码模板组集合UpdateTemplateGroupCollection

UpdateTemplateGroup

修改自定义转码模板组

PUT
https://vod.ap-southeast-2.myhuaweicloud.com/v1.0/{project_id}/asset/template_group/transcodings
高级设置
只看必填项
填写默认值
密文显示特定参数
*
Region
Headers
*
Authorization
*
X-Sdk-Date
Parameters
*
project_id
Body
*{
*
group_id
:
*
name
:
*
status
:
*
auto_encrypt
:
*
quality_info_list
: [
* {
*
video
: {
*
quality
:
*
width
:
*
height
:
*
bitrate
:
*
frame_rate
:
*}
*
audio
: {
*
sample_rate
:
*
bitrate
:
*
channels
:
*}
*
format
:
*}
+Add
*]
*
watermark_template_ids
: [
+Add
*]
*
description
:
*
common
: {
*
pvc
:
*
pvc_version
:
*
video_codec
:
*
audio_codec
:
*
hls_interval
:
*}
}

功能介绍

当前页面接口为历史版本API,未来可能停止维护,建议您使用新转码模板管理API。您也可以通过视频点播控制台使用转码功能,具体请参见转码设置

修改自定义转码模板组。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

PUT /v1.0/{project_id}/asset/template_group/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参数

参数

是否必选

参数类型

描述

group_id

String

模板组ID。

name

String

模板组名称。

status

String

是否设置默认。

auto_encrypt

Integer

是否自动加密。

取值如下:

  • 0:表示不加密。
  • 1:表示需要加密。

默认值:0。

加密与转码必须要一起进行,当需要加密时,转码参数不能为空,且转码输出格式必须要为HLS。

quality_info_list

Array of QualityInfo objects

画质配置信息列表。

watermark_template_ids

Array of strings

绑定的水印模板组ID数组。

description

String

模板介绍。

common

Common object

模板信息。

表4 QualityInfo

参数

是否必选

参数类型

描述

video

VideoTemplateInfo object

模板视频信息

audio

AudioTemplateInfo object

模板音频信息

format

String

格式。

表5 VideoTemplateInfo

参数

是否必选

参数类型

描述

quality

String

画质。

width

Integer

视频宽度。

height

Integer

视频高度。

bitrate

Integer

码率。

frame_rate

Integer

帧率(默认为1,1代表自适应,单位是帧每秒)。

表6 AudioTemplateInfo

参数

是否必选

参数类型

描述

sample_rate

Integer

音频采样率(有效值范围)

  • 1:AUDIO_SAMPLE_AUTO
  • 2:AUDIO_SAMPLE_22050
  • 3:AUDIO_SAMPLE_32000
  • 4:AUDIO_SAMPLE_44100
  • 5:AUDIO_SAMPLE_48000
  • 6:AUDIO_SAMPLE_96000

默认值为1。

bitrate

Integer

音频码率(单位:Kbps)。

channels

Integer

声道数(有效值范围)

  • 1:AUDIO_CHANNELS_1
  • 2:AUDIO_CHANNELS_2
表7 Common

参数

是否必选

参数类型

描述

pvc

String

pvc开关。

pvc_version

String

pvc版本。

video_codec

String

视频编码格式。

audio_codec

String

音频编码格式(有效值范围)

  • 1:AUDIO_CODECTYPE_AAC
  • 2:AUDIO_CODECTYPE_HEAAC1
  • 3:AUDIO_CODECTYPE_HEAAC2
  • 4:AUDIO_CODECTYPE_MP3

默认值为1。

hls_interval

Integer

分片时长(默认为5秒)。

响应参数

状态码: 400

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

PUT https://{endpoint}/v1.0/{project_id}/asset/template_group/transcodings

{
  "group_id" : "f9b045e0811c482f9de0d436a5927bb6",
  "name" : "template_group_test",
  "type" : "custom_template_group",
  "auto_encrypt" : 0,
  "quality_info_list" : [ {
    "video" : {
      "width" : 1280,
      "height" : 720,
      "bitrate" : 1000,
      "quality" : "HD",
      "frame_rate" : 1
    },
    "audio" : {
      "sample_rate" : 1,
      "channels" : 2,
      "bitrate" : 0
    },
    "format" : "HLS"
  } ],
  "status" : "0",
  "watermark_template_ids" : [ ],
  "common" : {
    "pvc" : "0",
    "video_codec" : "H264",
    "audio_codec" : "AAC",
    "hls_interval" : 5
  }
}

响应示例

状态码: 400

处理失败返回。

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

状态码

状态码

描述

204

处理成功返回。

400

处理失败返回。

错误码

请参见错误码

变更历史
2023-05-25
修改自定义转码模板组
PUT
   UpdateTemplateGroup
修改
变更参数

本文导读

功能介绍
调试
URI
请求参数
响应参数
请求示例
响应示例
状态码
错误码
变更历史