华为云用户手册

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必选。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 tasks Array of TakeOverTask objects 托管任务信息。 total Integer 任务数量。 表5 TakeOverTask 参数 参数类型 描述 bucket String 桶名。 object String 目录/文件名。 host_type Integer 托管类型。 取值如下： 0：表示存储到点播桶 1：表示存储在租户桶 2：表示存储到租户OBS桶中，且输出目录与源文件的存储目录相同。 output_bucket String 输出桶 。 output_path String 输出路径 。 task_id String 任务ID。 suffix Array of strings 托管文件类型。 template_group_name String 转码模板组 。 create_time String 创建时间。 end_time String 结束时间。 status String 任务状态。 exec_desc String 媒资的任务执行描述汇总。 状态码：403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

URI GET /v1.0/{project_id}/asset/obs/host/stock/task 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 status 否 String 任务状态。 task_id 否 String 任务ID。 page 否 Integer 分页编号，默认为0。 size 否 Integer 每页记录数。 默认10，范围[1,100]，指定task_id时该参数无效。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

响应示例 状态码：200 处理成功返回。 { "tasks" : [ { "bucket" : "obs-test", "object" : "play_violin.mp4", "host_type" : 0, "output_bucket" : "", "output_path" : null, "task_id" : "973", "suffix" : [ ], "template_group_name" : null, "create_time" : "20210629074248", "end_time" : "20210629074250", "status" : "SUCCEED", "exec_desc" : null } ], "total" : 1} 状态码：403 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}."}

请求示例 创建转码模板 POST https://{endpoint}/v2/{project_id}/asset/template/transcodingsContent-Type: application/json{ "name": "trans_template_test", "is_default": true, "is_auto_encrypt": false, "quality_info_list": [ { "video": { "width": 1280, "height": 720, "bitrate": 1000, "quality": "HD", "frame_rate": 0 }, "audio": { "sample_rate": "AUDIO_SAMPLE_AUTO", "channels": "AUDIO_CHANNELS_1", "bitrate": 0 } } ], "watermark_template_ids": [], "common": { "pvc": false, "video_codec": "H264", "audio_codec": "AAC", "format": "HLS", "hls_interval": 5 }}

请求参数 表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 模板组名称 is_default 否 Boolean 是否设置成默认转码模板，默认false不设置为默认 is_auto_encrypt 否 Boolean 配置是否加密输出音视频，默认false不加密。 当前只支持加密输出HLS格式的音视频流，不会对原始上传的音视频进行加密处理。非HLS转码输出的音视频格式，此字段不可配置。开启此配置前，请参考《VOD用户指南》的“HLS加密设置”章节获取密钥URL。 quality_info_list 是 Array of QualityInfoList objects 画质配置信息列表 common 是 CommonInfo object 高清低码开关，编码格式多路共同参数 watermark_template_ids 否 Array of strings 绑定的水印模板组ID数组 description 否 String 模板介绍 表4 QualityInfoList 参数 是否必选 参数类型 描述 video 否 VideoInfo object 模板视频信息。video和audio至少配置一个参数。 audio 否 AudioInfo object 模板音频信息 表5 VideoInfo 参数 是否必选 参数类型 描述 quality 是 String 画质 4K默认分辨率3840*2160，码率8000kbit/s 2K默认分辨率2560*1440，码率7000kbit/s FULL_HD默认分辨率1920*1080，码率3000kbit/s HD默认分辨率1280*720，码率1000kbit/s SD默认分辨率854*480，码率600kbit/s FLUENT默认分辨率480*270，码率300kbit/s width 否 Integer 视频宽度 H264编码：0或[32,4096]之间2的整数倍 H265编码：0或[160,4096]之间2的整数倍 height 否 Integer 视频高度 H264编码：0或[32,2880]之间2的整数倍 H265编码：0或[160,2880]之间2的整数倍 bitrate 是 Integer 平均码率，单位：kbit/s。 参考取值范围：0或[40,30000]之间的整数。 frame_rate 是 Integer 帧率，单位是帧每秒。 取值范围：[0-75]之间的整数，小于5帧或大于60帧代表自适应。 表6 AudioInfo 参数 是否必选 参数类型 描述 sample_rate 是 String 音频采样率（有效值范围） AUDIO_SAMPLE_AUTO (default), AUDIO_SAMPLE_22050：22050Hz AUDIO_SAMPLE_32000：32000Hz AUDIO_SAMPLE_44100：44100Hz AUDIO_SAMPLE_48000：48000Hz AUDIO_SAMPLE_96000：96000Hz bitrate 否 Integer 音频码率（单位：Kbps） channels 是 String 声道数（有效值范围） AUDIO_CHANNELS_1:单声道 AUDIO_CHANNELS_2：双声道 (default) AUDIO_CHANNELS_5_1：5.1声道 表7 CommonInfo 参数 是否必选 参数类型 描述 pvc 否 Boolean 高清低码开关 video_codec 否 String 视频编码格式 H264 H265 audio_codec 否 String 音频编码格式 AAC：AAC格式 (default) HEAAC1：HEAAC1格式 HEAAC2：HEAAC2格式 MP3：MP3格式 is_black_cut 否 Boolean 黑边剪裁类型，默认false不开启黑边剪裁 format 是 String 转码格式 MP4 HLS DASH DASH_HLS MP3 ADTS UNKNOW hls_interval 否 Integer 分片时长，范围2-10（默认为5秒） upsample 否 Boolean 上采样开关，开启后可以提升视频的分辨率，增加采样点的数量，默认值:false，表示不开启上采样。 adaptation 否 String 转码后的片源分辨率自适应方式。 取值如下： SHORT：短边自适应。转码模板的宽和高都设置，用其中的短边与片源短边对比，然后片源长边按此比例进行缩放。 LONG：长边自适应。转码模板的宽和高都设置，用其中的长边与片源长边对比，然后片源短边按此比例进行缩放。 NONE：按设置宽高适应，为默认值。按照转码模板设置的宽高输出。 说明： V1接口（已废弃）不支持设置该参数，默认按SHORT处理。V2接口默认按NONE处理，V1和V2接口默认值有差异，在调用时需要注意该参数值的设置。 控制台是通过V2接口创建的转码模板，实际与V1接口创建转码模板的默认值保持一致，为SHORT。 preset 否 Integer 编码质量等级，取值[0,2] 0表示默认方式，1表示转码效率优先，2表示转码质量优先。 max_iframes_interval 否 Integer I帧最大间隔，取值范围：[2，10]。默认值：5，单位秒。 hls_audio_separate 否 Boolean 转码后音频是否独立存储。 hls_segment_type 否 String HLS分片的封装格式，目前支持TS和FMP4，默认TS格式

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 VOD.10053 The request parameter is illegal. 请求参数非法，字段填写错误 请检查字段填写是否和接口定义一致 400 VOD.10081 The request parameters are illegal, please check. 请求参数非法，请检查。 请求参数非法，请检查。 400 VST.10001 The request parameter is illegal. 请求参数非法，字段填写错误 请检查字段填写是否和接口定义一致 400 VST.10002 Internal system error. 系统内部一般性错误 请联系技术支持 400 VST.10004 Identity authentication failed. 身份认证失败 请检查Token等认证参数是否正确 403 VOD.10051 Internal system error. 系统内部一般性错误 请联系技术支持 403 VOD.10052 The internal communication of the service is abnormal. 服务内部通信异常 请联系技术支持 403 VOD.10054 Identity authentication failed. 身份认证失败 请检查Token等认证参数是否正确 403 VOD.10055 The user is not authenticated by real name. 用户在 CS B完成未实名认证 请检查是否完成实名认证 403 VOD.10056 The user is in an abnormal state. 用户处于异常状态 请检查用户状态是否正确 403 VOD.10057 Tenant ID verification failed. 租户ID校验失败 请检查租户ID是否正确 403 VOD.10058 The request method is incorrect. 请求方式不正确 请检查请求方式 403 VOD.10059 The requested content type is incorrect. 请求内容类型不正确 请检查请求内容类型 403 VOD.10060 Media asset is not downloaded successfully or not released, please check. 媒资处于未下载成功或者未发布状态，请检查。 媒资处于未下载成功或者未发布状态，请检查。 403 VOD.10061 The operation failed, and the current media asset status is not allowed to be updated. 操作失败,当前媒资状态不允许更新。 操作失败,当前媒资状态不允许更新。 403 VOD.10063 Media asset type is not supported at this time. 媒资类型暂不支持。 媒资类型暂不支持。 403 VOD.10065 Media asset classification already exists, please check. 媒资分类已存在，请检查。 媒资分类已存在，请检查。 403 VOD.10066 The media asset classification exceeds the maximum level, please check. 媒资分类超过最大层级，请检查。 媒资分类超过最大层级，请检查。 403 VOD.10067 Media asset classification exceeds the maximum number limit, please check. 媒资分类超过最大个数限制，请检查。 媒资分类超过最大个数限制，请检查。 403 VOD.10069 The topic already exists, please check. 主题已存在，请检查。 主题已存在，请检查。 403 VOD.10070 Set message notification failed, no permission to post message to topic, please check. 设置 消息通知 失败，无权限发布消息到主题，请检查。 设置消息通知失败，无权限发布消息到主题，请检查。 403 VOD.10071 Referer header field verification failed, please check. Referer头域校验失败，请检查。 Referer头域校验失败，请检查。 403 VOD.10072 The url authentication setting failed. The old key has not expired. The new key cannot be set. Please set the new key again after expiration. url鉴权设置失败，旧密钥尚未过期，无法设置新密钥，过期后请再次设置新密钥。 url鉴权设置失败，旧密钥尚未过期，无法设置新密钥，过期后请再次设置新密钥。 403 VOD.10073 Failed to create a media asset transcoding task. Contact technical support. 创建媒资转码任务失败，请联系技术支持。 创建媒资转码任务失败，请联系技术支持。 403 VOD.10074 There is no permission to perform this operation. 无权限执行该操作。 无权限执行该操作。 403 VOD.10076 Failed to get the object storage source file. 获取对象存储源文件失败。 获取对象存储源文件失败。 403 VOD.10077 hms request playback interface authentication failed. hms请求播放接口鉴权失败。 hms请求播放接口鉴权失败。 403 VOD.10078 The public measurement limit, the usage exceeds the threshold. 公测限额，用量超过阈值。 公测限额，用量超过阈值。 403 VOD.10079 The task was processed successfully. 任务处理成功。 任务处理成功。 403 VOD.10080 The task is being processed. 任务处理中。 任务处理中。 403 VOD.10082 The template group already exists. 模板组已存在。 模板组已存在。 403 VOD.10083 The current media asset status does not support this operation. 当前媒资或资源状态不支持该操作。 当前媒资或资源状态不支持该操作。 403 VOD.10084 Media asset release failed. 媒资发布失败。 媒资发布失败。 403 VOD.10085 The number of domain names allowed to be created cannot exceed {0}. 允许创建的 域名 数不能超过{0}个。 允许创建的域名数不能超过{0}个。 403 VOD.10086 The total number of preheating urls cannot exceed {0}. 预热url总数不能超过{0}个。 预热url总数不能超过{0}个。 403 VOD.10087 The total number of refresh urls cannot exceed {0}. 刷新url总数不能超过{0}个。 刷新url总数不能超过{0}个。 403 VOD.10088 Only operate enabled domain name. 只能操作已启用的域名。 只能操作已启用的域名。 403 VOD.10090 The modification failed, request to confirm the watermark image upload first. 修改失败，请求先确认水印图片上传 修改失败，请求先确认水印图片上传 403 VOD.10091 Media asset transcoding was successful. 媒资转码成功。 媒资转码成功。 403 VOD.10092 Media asset transcoding failed. 媒资转码失败。 媒资转码失败。 403 VOD.10093 The OBS transfer media asset was successfully released. OBS转存媒资发布成功。 OBS转存媒资发布成功。 403 VOD.10094 The OBS transfer media asset failed to be released. OBS转存媒资发布失败。 OBS转存媒资发布失败。 403 VOD.10095 The source domain name cannot be configured to speed up the domain name. 源站域名不能配置为加速域名。 源站域名不能配置为加速域名。 403 VOD.10096 The domain name has been used. 该域名已被使用。 该域名已被使用。 403 VOD.10097 Default accelerated domain name cannot be created. 默认加速域名不能进行创建。 默认加速域名不能进行创建。 403 VOD.10098 Operation failed, domain name is configuring. 操作失败，域名配置中。 操作失败，域名配置中。 403 VOD.10099 Media asset is BLOCKED. 媒资处于屏蔽状态 媒资处于屏蔽状态 403 VOD.10100 No key URL has been configured. 未配置获取密钥URL。 未配置获取密钥URL。 403 VOD.10101 Unable to get the key because there is no encryption. 媒资未加密，无法获取密钥。 媒资未加密，无法获取密钥。 403 VOD.10102 Edit task only support Mp4/Flv video. 剪辑任务当前只支持Mp4和Flv片源 剪辑任务当前只支持Mp4和Flv片源 403 VOD.10103 Concat index asset must in input asset list. 参考视频必须是待拼接视频列表中的一员 参考视频必须是待拼接视频列表中的一员 403 VOD.10104 The thumbnail task failed. 截图任务失败 截图任务失败 403 VOD.10105 The review task failed. 审核任务失败 审核任务失败 403 VOD.10106 Cannot delete the default assigned domain name or default domain name. 不能删除默认分配域名或者默认域名。 不能删除默认分配域名或者默认域名。 403 VOD.10107 Default allocation of domain names cannot configure Https. VOD默认分配域名不能配置Https。 VOD默认分配域名不能配置Https。 403 VOD.10108 The interval of Cut task is too small. 剪切间隔时长过小 剪切间隔时长过小 403 VOD.10109 TinyAsset preheat url is over 10 limit. 最多预热10个短视频指定URL 最多预热10个短视频指定URL 403 VOD.10110 Unable to create cdn preHeating task, please check if the asset is enabled for cdn. 无法创建cdn预热任务，请检查该媒资是否启用cdn加速域名 无法创建cdn预热任务，请检查该媒资是否启用cdn加速域名 403 VOD.10111 No access to resources. 无权限访问资源 无权限访问资源 403 VOD.10113 OBS notify config is not set. OBS事件通知未配置 OBS事件通知未配置 403 VOD.10114 Bucket not Authorized. 桶未授权 桶未授权 403 VOD.10115 The output bucket can not be cannel auth. 已设置为输出的桶无法取消授权 已设置为输出的桶无法取消授权 403 VOD.10116 Event notification is being configured for OBS. 正在为OBS服务配置事件通知。 正在为OBS服务配置事件通知。 403 VOD.10117 Transcode template is used in hosting task. 转码模板已在音视频托管中启用，无法删除。若想删除，请先停用音视频托管中的转码模板。 转码模板已在音视频托管中启用，无法删除。若想删除，请先停用音视频托管中的转码模板。 403 VOD.10118 Bucket asset is handling.. 该桶的音视频同步中 该桶的音视频同步中 403 VOD.10119 URL mapping already exists. URL映射已经存在 URL映射已经存在 403 VOD.10120 You have arrears, please recharge. 您已欠费，请尽快充值 您已欠费，请尽快充值 403 VOD.10121 URL pull asset failed. URL拉取媒资失败 URL拉取媒资失败 403 VOD.10122 Cancel url pull failed. 取消URL拉取失败 取消URL拉取失败 403 VOD.10123 The url pull task is processing or stopping can not be delete. 不能删除处理中或取消中的URL拉取任务 不能删除处理中或取消中的URL拉取任务 403 VOD.10124 Watermark template is valid or not exists, {0} 水印模板组无效或不存在，{0} 水印模板组无效或不存在，{0} 403 VOD.10125 Watermark number reach limitation: {0} 水印数量达到上限：{0} 水印数量达到上限：{0} 403 VOD.10126 Uploading confirmation is not allowed in the current media asset status. Please check the media asset status. 媒资当前状态不允许进行上传确认，请确认媒资状态 媒资当前状态不允许进行上传确认，请确认媒资状态 403 VOD.10127 APIGW rate limit. MAI流控限制 MAI流控限制 403 VOD.10128 The task status does not support recovery operations. 任务状态不支持恢复操作 任务状态不支持恢复操作 403 VOD.10130 The domain name does not support configuration key anti-theft chain: {0}. 域名不支持配置防盗链：{0} 域名不支持配置防盗链：{0} 403 VOD.10131 The watermark template already exists. 水印模板已经存在。 水印模板已经存在。 403 VOD.10132 Account cancellation or public security freeze, access to services is not allowed. 账户注销或公安冻结，不允许访问服务。 账户注销或公安冻结，不允许访问服务。 403 VOD.10133 No permission to operate related resource. 无权限操作相关的资源。 无权限操作相关的资源。 403 VOD.10134 The domain name is invalid and cannot be created. 域名无效，无法创建。 域名无效，无法创建。 403 VOD.10135 The asset is not in the upload state and cannot obtain temporary authorization. 媒资没有处于上传中状态，无法获取临时授权 媒资没有处于上传中状态，无法获取临时授权 403 VOD.10136 This feature is temporarily offline. 该功能临时下线。 该功能临时下线。 403 VOD.10137 The number of published or unpublished meta resources exceeds the threshold limit:{0} 发布或取消发布媒资个数超过阈值限制：{0} 发布或取消发布媒资个数超过阈值限制：{0} 403 VOD.10138 You do not have permission to operate, contact a tenant administrator barrel authorize or sub-account to the tenant administrator privileges conferred OBS. 您没有操作权限，请联系租户管理员进行桶授权或者租户管理员给子账号赋予OBS权限 您没有操作权限，请联系租户管理员进行桶授权或者租户管理员给子账号赋予OBS权限 404 VOD.10062 Media asset or resource does not exist, please check. 媒资或资源不存在，请检查。 媒资或资源不存在，请检查。 404 VOD.10064 Media asset classification does not exist, please check. 媒资分类不存在，请检查。 媒资分类不存在，请检查。 404 VOD.10068 The theme does not exist, please check. 主题不存在，请检查。 主题不存在，请检查。 404 VOD.10075 The object storage source address or destination address is incorrect. Please check. 对象存储源地址或者目的地址不正确，请检查。 对象存储源地址或者目的地址不正确，请检查。 404 VOD.10089 Accelerated domain name does not exist. 加速域名不存在。 加速域名不存在。 404 VOD.10112 OBS Resource not exists. OBS桶资源不存在 请检查OBS资源或联系技术支持 404 VOD.10129 Subtitle resource does not exist, please check. 字幕文件未找到，请检查 字幕文件未找到，请检查 404 VOD.10150 Workflow does not exist, please check. 工作流不存在 请检查工作流配置或联系技术支持 404 VOD.10151 TemplateGroup does not exist, please check. 转码模板不存在 请检查转码模板配置或联系技术支持 404 VOD.10152 Domain does not exist, please check. 无可用域名 请检查域名配置或联系技术支持 500 VOD.10051 Internal system error. 系统内部一般性错误 请联系技术支持 500 VST.10002 Internal system error. 系统内部一般性错误 请联系技术支持 父主题： 附录

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 total Integer 记录总数 summary_results Array of AssetDailySummaryResult objects 日志文件列表 表5 AssetDailySummaryResult 参数 参数类型 描述 date String 播放日期，格式为：yyyyMMdd000000。 link String 日播放统计数据文件的下载地址，有效期为12个小时。 文件内容格式：[域名]\t[媒资ID]\t[日期]\t[播放流量]\t[播放次数] 播放次数统计说明： HLS文件：访问M3U8文件时会统计播放次数，访问TS文件时不会统计播放次数。 其它文件：如MP4文件，当播放请求带有range且range的start参数不等于0时，不统计播放次数。其它情况下，会统计播放次数。 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

响应示例 状态码：200 处理成功返回。 { "total" : 1, "summary_results" : [ { "date" : "20231201000000", "link" : "http://cdn-log-user-bj4.obs.cn-north-4.myhuaweicloud.com:80/asset-play-summary/05a8aee14d8026a92fcdc018fe235c2c/20231201-asset-play-summary.gz?AccessKeyId=QXBNBGA2GW9EP2XXOYUN&Expires=1701786544&Signature=kZYh0hEos2V**********AHGyXA%3D" } ]} 状态码：400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}."}

URI GET /v1/{project_id}/asset/daily-summary 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID 表2 Query参数 参数 是否必选 参数类型 描述 start_time 是 String 查询开始时间。仅支持查询一年内的数据，且一次查询的日期跨度不能超过90天。 如果查询指定开始日期的数据，格式为：yyyyMMdd000000。 end_time 是 String 查询结束时间。仅支持查询一年内的数据，且一次查询的日期跨度不能超过90天。 如果查询指定结束日期的数据，格式为：yyyyMMdd000000。 offset 否 Integer 偏移量，表示查询该偏移量后面的记录。 limit 否 Integer 查询返回记录的数量限制。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 total Integer 日志总数。 logs Array of CdnLog objects 日志列表数据。 表5 CdnLog 参数 参数类型 描述 domain_name String 域名名称。 start_time String 查询起始时间。 end_time String 查询结束时间。 name String 日志名称。 size Long 日志大小。 单位：byte。 link String 日志下载链接。 日志文件中的字段说明请参见日志管理。 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码：200 处理成功返回。 { "total" : 1, "logs" : [ { "domain_name" : "1866.cdn-vod.huaweicloud.com", "start_time" : "2021-12-23 23:00:00", "end_time" : "2021-12-24 00:00:00", "name" : "2021122323-1866.cdn-vod.huaweicloud.com-cn.gz", "size" : 225, "link" : "http://cdn-log-user-bj4.obs.cn-north-4.myhuaweicloud.com:80/mainland/20211223/23/2021122323-1866.cdn-vod.huaweicloud.com-cn.gz?AccessKeyId=AOV5GWALBMNTLIYDEQLV&Expires=1641433717&response-content-disposition=attachment%3Bfilename%3D%222021122323-1866.cdn-vod.huaweicloud.com-cn.gz%22&Signature=kZYh0hEos2V**********AHGyXA%3D" } ]} 状态码：400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}."}

URI GET /v1.0/{project_id}/vod/cdn/logs 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 domain_name 是 String 加速域名，参考格式：www.test1.com。 query_date 是 String 查询开始时间，格式为yyyyMMddHHmmss。 查询结果为开始时间之后24小时内的日志数据 只能查最近一个月内的数据 page_size 否 Integer 每页显示日志数量。取值范围为[1,10000]，默认值：10000。 page_number 否 Integer 当前页数。取值范围为[1,65535]，默认值：1。

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 template_group_collection_list Array of TemplateGroupCollection objects 模板组集合信息 total Integer 总记录条数 表5 TemplateGroupCollection 参数 参数类型 描述 group_collection_id String 模板组集合id name String 模板组集合名称 description String 模板介绍 template_group_list Array of TemplateGroup objects 转码组列表 表6 TemplateGroup 参数 参数类型 描述 group_id String 模板组id name String 模板组名称 status String 是否默认 type 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 高清低码开关，高清低码版本，编码格式多路共同参数 表7 QualityInfo 参数 参数类型 描述 video VideoTemplateInfo object 模板视频信息 audio AudioTemplateInfo object 模板音频信息 format String 格式。 表8 VideoTemplateInfo 参数 参数类型 描述 quality String 画质。 width Integer 视频宽度。 height Integer 视频高度。 bitrate Integer 码率。 frame_rate Integer 帧率（默认为1，1代表自适应，单位是帧每秒）。 表9 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 表10 Common 参数 参数类型 描述 pvc String 高清低码开关。 pvc_version String 高清低码版本。 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 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

URI GET /v1.0/{project_id}/asset/template-collection/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 group_collection_id 否 String 模板组集合id offset 否 Integer 偏移量。默认为0。指定group_collection_id时该参数无效。 limit 否 Integer 每页记录数。默认为10，范围[1,100]。指定group_collection_id时该参数无效。

响应示例 状态码：200 处理成功返回。 { "template_group_collection_list" : [ { "group_collection_id" : "9751249d25f14587b212544d6fd8dcf8", "name" : "test", "template_group_list" : [ { "group_id" : "9751249d25f14587b212544d6fd8dcf8", "name" : "test112", "status" : "0", "type" : "custom_template_group", "auto_encrypt" : 0, "quality_info_list" : [ { "video" : { "quality" : "UNKNOW", "width" : 0, "height" : 0, "bitrate" : 0, "frame_rate" : 0 }, "audio" : null, "format" : "UNKNOW" } ], "watermark_template_ids" : null, "description" : null, "common" : { "pvc" : null, "pvc_version" : null, "video_codec" : null, "audio_codec" : "AAC", "hls_interval" : 0 } } ] } ], "total" : 1} 状态码：400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}."}

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

请求参数 表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参数 参数 是否必选 参数类型 描述 id 是 String 水印配置模板id。 status 是 String 水印上传状态，传值支持"SUCCEED"和"FAILED"。

响应示例 状态码：200 处理成功返回。 { "id" : "2305739f855413a84af9e6ad6e2b21be", "image_url" : "https://vod-bucket-26-cn-north-4.obs.cn-north-4.myhuaweicloud.com:443/05ab5cef408026f22f62c018de60cf2e/a52ba84366abebb4c4614e1b16973549/watermark.png?AWSAccessKeyId=CBN2J**********0RCSN&Expires=1625479312&Signature=kZYh0hEos2V**********AHGyXA%3D"} 状态码：400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}."}

请求示例 DELETE https://{endpoint}/v1/{project_id}/asset/transcode-productContent-Type: application/json{ "asset_id": "8c53b4038ea3d8694f1a8a7ac95f612f", "delete_type": "PRODUCT", "delete_infos": [ { "group_id": "9171008cca7f47909c61f61a65d4c906", "products": [ { "url": "https://103-cn-north-4.cdn-vod.huaweicloud.com/asset/8c53b4038ea3d8694f1a8a7ac95f612f/play_multi_video/9171008cca7f47909c61f61a65d4c906/38a92b74ead764ad21aa5355bad5193e.mp4" } ] } ]} DELETE https://{endpoint}/v1/{project_id}/asset/transcode-productContent-Type: application/json{ "asset_id": "6f306b4cc58c39b2a97ad797367b88ad", "delete_type": "GROUP", "delete_infos": [ { "group_id": "02e6887dd6bf48299922eec52d192115" } ]}

响应示例 状态码：200 处理成功返回。 { "status" : "SUC CES S", "deleted_products" : [ { "group_id" : "9171008cca7f47909c61f61a65d4c906", "products" : [ { "url" : "https://103-cn-north-4.cdn-vod.huaweicloud.com/asset/8c53b4038ea3d8694f1a8a7ac95f612f/play_multi_video/9171008cca7f47909c61f61a65d4c906/da6613ac132eda54b2f4ab67adbf56bd.mp4" } ] } ], "failed_products" : [ ]} 状态码：403 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}."}

请求参数 表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参数 参数 是否必选 参数类型 描述 asset_id 否 String 媒资ID。 delete_type 否 String GROUP：模板组级删除。 PRODUCT：产物级删除 delete_infos 否 Array of ProductGroupInfo objects 删除的产物信息，最多传100个产物信息。 表4 ProductGroupInfo 参数 是否必选 参数类型 描述 group_id 否 String 模板组ID products 否 Array of ProductUrlInfo objects 产物信息 表5 ProductUrlInfo 参数 是否必选 参数类型 描述 url 否 String 删除的产物URL

响应参数 状态码：200 表6 响应Body参数 参数 参数类型 描述 asset_id String VOD分配的媒资ID，仅支持查询，不支持修改。 status String SUCCESS：成功 FAIL：失败 PARTIAL_SUCCESS：部分成功 deleted_products Array of ProductGroupInfo objects 删除成功的产物 failed_products Array of ProductGroupDelFailInfo objects 删除失败的产物 表7 ProductGroupInfo 参数 参数类型 描述 group_id String 模板组ID products Array of ProductUrlInfo objects 产物信息 表8 ProductUrlInfo 参数 参数类型 描述 url String 删除的产物URL 表9 ProductGroupDelFailInfo 参数 参数类型 描述 group_id String 模板组ID fail_reason String 模板组删除失败的原因 products Array of ProductDelFailInfo objects 删除失败的产物的信息 表10 ProductDelFailInfo 参数 参数类型 描述 url String 删除产物的URL fail_reason String 删除产物失败的原因 状态码：403 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

URI GET /v1/{project_id}/asset/vod-retrieval 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 start_time 否 String 开始时间 end_time 否 String 结束时间 interval 否 Integer 采样间隔，单位：秒，取值说明： 时间跨度1天：1小时、4小时、8小时，分别对应3600秒、14400秒和28800秒。 时间跨度2~7天：1小时、4小时、8小时、1天，分别对应3600秒、14400秒、28800秒和86400秒。 时间跨度8~31天：4小时、8小时、1天，分别对应14400秒、28800秒和86400秒。 如果不传，默认取对应时间跨度的最小间隔。

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 start_time String 统计起始时间 interval Integer 采样时间间隔 sample_data Array of VodRetrievalData objects 表5 VodRetrievalData 参数 参数类型 描述 retrieval_warm Double 低频存储的媒资恢复为标准存储后的文件大小 retrieval_cold Double 归档存储的媒资按标准取回模式取回的文件大小 retrieval_cold_speed Double 归档存储的媒资按快速取回模式取回的文件大小 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。