华为云用户手册

请求参数 表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 模板组集合名称 collection_id 是 String 模板组集合ID description 否 String 模板组集合介绍 template_group_list 否 Array of strings 模板组列表

请求示例 修改转码模板集合 POST https://{endpoint}/v1.0/{project_id}/asset/template-collection/transcodingsContent-Type: application/json{ "collection_id": "f9b045e0811c482f9de0d436a5927bb6", "name": "test", "template_group_list": [ "780640dd1d584a6999b104568c358b78", "6a16d8d0161c42caa42b9c148d032871" ]}

响应示例 状态码：200 处理成功返回。 { "start_time" : "20190528000000", "interval" : 3600, "sample_data" : [ { "storage" : 0, "transcode" : 0 } ]} 状态码：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方式认证时必选，请求的发生时间。

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 start_time String 统计起始时间。 interval Integer 统计间隔。 sample_data Array of VodSampleData objects 采样数据数组。从start_time开始，每个间隔对应一个采样数据（其中转码时长单位：min，存储单位：GB）。 表5 VodSampleData 参数 参数类型 描述 storage Float 标准存储空间。 单位：GB。 storage_warm Float 低频存储空间。 单位：GB。 storage_cold Float 归档存储空间。 单位：GB。 transcode Long 转码时长。 单位：分钟。 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码：200 处理成功返回。 { "asset_id" : "f488337c31c8e4622f1590735b134c65", "cover_upload_url" : "https://obs.cn-north-4.myhuaweicloud.com:443/obs-vod-1/%7Bproject_id%7D/f488337c31c8e4622f1590735b134c65/cover/Cover0.jpg?AWSAccessKeyId=CBN2J**********0R CS N&Expires=1518148410&Signature=kZYh0hEos2V**********AHGyXA%3D", "subtitle_upload_urls" : [ "https://obs-vod-1.obs.cn-north-4.myhuaweicloud.com:443/14ce1d4437164aba8b364ce15866154e/53a018d2dc53ca07eb5a07a839205c9d/subtitle/1.srt?AWSAccessKeyId=CBN2J**********0RCSN&Expires=1534760131&Signature=kZYh0hEos2V**********AHGyXA%3D" ]} 状态码：403 处理失败返回。 { "error_code" : "VOD.10062", "error_msg" : "Media asset or resource does not exist, please check."}

URI GET /v1.0/{project_id}/asset/vod-statistics 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 start_time 否 String 起始时间，格式为yyyymmddhhmmss。 end_time 否 String 结束时间，格式为yyyymmddhhmmss。 “start_time”、“end_time”均不存在时，“start_time”取当天零点，“end_time”取当前时间。 “start_time”不存在、“end_time”存在，请求非法。 “start_time”存在、“end_time”不存在，“end_time”取当前时间。 只能查询最近三个月内的数据，且时间跨度不能超过31天。 起始时间和结束时间会自动规整，起始时间规整为指定时间所在的整点时刻，结束时间规整为指定时间所在时间的下一小时整点时刻。 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秒。 单位：秒。 若不设置，默认取对应时间跨度的最小间隔。

接口约束 视频更新接口只支持更新下载失败、已取消和上传失败状态的媒资 请求Body参数的设置要求，如下所示： 参数video_name、cover_type、subtitles必须至少设置一个。 如果更新视频，参数video_name、video_type为必填项，不能为空值。 如果更新封面，参数cover_type为必填项，不能为空值，如果携带cover_id，则必须填0。 如果上传字幕文件，参数subtitles的id、type和language为必填项，不能为空值。 如果未按照上述要求设置参数，将无法正常返回接口响应消息。

请求示例 更新媒资 PUT https://{endpoint}/v1.0/{project_id}/assetContent-Type: application/json{ "asset_id": "f488337c31c8e4622f1590735b134c65", "cover_id": "0", "cover_type": "JPG", "subtitles": [ { "id": 1, "language": "CN", "type": "SRT", "md5": "SqcyFjJZoDZaP8oKIY6rgQ==", "description": "AAAAA" } ]}

请求参数 表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 VOD分配的媒资ID，仅支持查询，不支持修改。 video_md5 否 String 视频文件MD5值。建议参考《API参考》附录下生成MD5值的媒资上传和更新示例。 video_name 否 String 视频文件名。 文件名后缀为可选。 video_type 否 String 视频文件类型。 取值为MP4、TS、MOV、MXF、MPG、FLV、WMV、AVI、M4V、F4V、MPEG、3GP、ASF、MKV cover_id 否 Integer 封面ID。 取值范围：[0,7]。 当前只支持一张封面，只能设置为0。 cover_type 否 String 封面图片格式类型。 取值如下： JPG PNG cover_md5 否 String 封面文件的MD5值。 subtitles 否 Array of Subtitle objects 字幕文件信息 表4 Subtitle 参数 是否必选 参数类型 描述 id 是 Integer 字幕id。 取值范围：[1,16]。 type 是 String 字幕文件类型，目前暂只支持“SRT”和“VTT”。 language 是 String 字幕语言类型。 name 否 String 字幕文件名称。 md5 否 String 字幕文件的MD5值。 description 否 String 字幕描述。

响应示例 状态码：200 处理成功返回。 { "id" : 334, "name" : "电影", "parent_id" : 0, "level" : 1, "projectId" : "58411d8df9064*****75d75b54e01358"} 状态码：400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}."}

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 name String 媒资分类名称。 parent_id Integer 父分类ID。 一级分类父ID为0。 id Integer 媒资分类ID。 level Integer 媒资分类层级。 取值如下： 1：一级分类层级。 2：二级分类层级。 3：三级分类层级。 projectId String 项目ID。 状态码：400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求参数 表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 媒资分类名称，最大64字节。 parent_id 否 Integer 父分类ID。 若不填，则默认生成一级分类。 根节点分类ID为0。

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用创建的用户进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域 指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。 可用区 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1 项目隔离模型

API流控 视频点播 服务设置了API流控限制，避免出现短时间内重复调用API，服务中断的情况。API流控限制说明如表2所示。 表2 API流控限制 接口分类 接口名称 单租户接口流控 （单位：次数/分钟） 接口总体流控 （单位：次数/分钟） 媒资上传 创建媒资：上传方式 获取分段上传授权 确认媒资上传 桶授权 创建媒资：OBS转存方式 1500 12000 创建媒资：OBS托管方式 创建媒资：URL拉取注入 上传检验 100 1000 媒资处理 视频更新 媒资处理 取消媒资转码任务 音频提取 取消提取音频任务 创建审核媒资任务 设置封面 100 1000 媒资管理 删除媒资 媒资发布 媒资发布取消 修改媒资属性 100 1000 查询媒资信息 1500 24000 查询指定媒资的详细信息 查询媒资列表 1500 12000 （即将下线）OBS托管管理 查询托管任务 查询托管任务详情 100 1000 查询托管媒资详情 1500 12000 媒资预热 CDN预热 查询CDN预热 100 1000 媒资分类 创建媒资分类 修改媒资分类 删除媒资分类 查询指定分类信息 100 1000 密钥查询 密钥查询 1500 12000 统计分析 查询CDN统计信息 查询源站统计信息 查询TopN媒资信息 查询 域名 播放日志 查询媒资日播放统计数据 100 1000 水印模板管理 创建水印模板 修改水印模板 查询水印列表 删除水印模板 确认水印图片上传 100 1000 转码模板管理 创建自定义转码模板 查询转码模板列表 修改转码模板 删除自定义模板 100 1000 转码模板集合管理 创建转码模板组集合 修改转码模板组集合 查询自定义模板组集合 删除转码模板组集合 100 1000 转码产物管理 删除转码产物 100 1000 媒资存储模式管理 修改媒资降冷粒度 修改媒资文件在OBS的存储模式 查询媒资降冷配置 100 1000

支持跨域请求的接口说明 目前视频点播服务仅以下接口支持浏览器跨域请求，如表1所示。 表1 支持跨域请求接口列表 接口名称 URI 创建媒资：上传方式 /v1.0/{project_id}/asset 确认媒资上传 /v1.0/{project_id}/asset/status/uploaded 上传检验 /v1.0/{project_id}/asset/duplication 查询媒资信息 /v1.0/{project_id}/asset/info （即将下线）查询托管媒资详情 /v1.0/{project_id}/asset/obs/host/task/details 获取分段上传授权 /v1.0/{project_id}/asset/authority

状态码 调用视频点播API时，可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 204 No Content 请求完全成功，同时HTTP响应不包含响应体。 400 Bad Request 非法请求。 建议直接修改该请求，不要重试该请求。 401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 Not Found 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405 Method Not Allowed 请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。 406 Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权。 408 Request Timeout 服务器等候请求时发生超时。 客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 500 Internal Server Error 表明服务端能被请求访问到，但是不能理解用户的请求。 501 Not Implemented 服务器不支持请求的功能，无法完成请求。 502 Bad Gateway 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 503 Service Unavailable 被请求的服务无效。 建议直接修改该请求，不要重试该请求。 504 Gateway Timeout 网关超时。 父主题： 附录

响应示例 状态码：202 处理成功返回 { "asset_id" : "f488337c31c8e4622f1590735b134c65", "audio_asset_id" : "5412"} 状态码：400 处理失败返回 { "error_code" : "VOD.10062", "error_msg" : "Media asset or resource does not exist, please check."}

请求参数 表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 VOD分配的媒资ID，仅支持查询，不支持修改。 parameter 否 Parameter object 需要提取音频的参数信息。 表4 Parameter 参数 是否必选 参数类型 描述 format 否 String 封装格式。 取值如下： MP3 AAC

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

请求示例 修改转码模板 PUT https://{endpoint}/v2/{project_id}/asset/template/transcodingsContent-Type: application/json{ "group_id": "f9b045e0811c482f9de0d436a5927bb6", "name": "trans_template_test", "is_default": true, "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参数 参数 是否必选 参数类型 描述 group_id 是 String 模板组ID name 否 String 模板组名称 is_default 否 Boolean 是否是默认转码模板，默认false不设置为默认 is_auto_encrypt 否 Boolean 配置是否加密输出音视频，默认false不加密。 当前只支持加密输出HLS格式的音视频流，不会对原始上传的音视频进行加密处理。非HLS转码输出的音视频格式，此字段不可配置。开启此配置前，请参考《VOD用户指南》的“HLS加密设置”章节获取密钥URL。 quality_info_list 否 Array of QualityInfoList objects 画质配置信息列表，如果不携带或者携带为空，则不更新模板中该部分数据。 watermark_template_ids 否 Array of strings 绑定的水印模板组ID数组 description 否 String 模板介绍 common 否 CommonInfo object 高清低码开关，编码格式多路共同参数 表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格式

请求示例 修改媒资属性 PUT https://{endpoint}/v1.0/{project_id}/asset/infoContent-Type: application/json{ "asset_id": "f488337c31c8e4622f1590735b134c65", "title": "Avatar", "description": "Avatar, marketed as James Cameron's Avatar, is a 2009 American epic\nscience fiction film directed, written, produced, and co-edited by\nJames Cameron", "category_id": "1"}

请求参数 表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 VOD分配的媒资ID，仅支持查询，不支持修改。 title 否 String 媒资标题，长度不超过128个字节，UTF-8编码。 description 否 String 媒资描述，长度不超过1024个字节。 category_id 否 Integer 媒资分类id。 tags 否 String 媒资标签。 单个标签不超过24个字节，最多不超过16个标签。 多个用逗号分隔，UTF-8编码。

响应示例 状态码：200 处理成功返回。 { "id" : 334, "name" : "film", "parent_id" : 0, "level" : 1, "projectId" : "58411d8df90649a39b75d75b54e01358"} 状态码：400 处理失败返回。 { "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参数 参数 是否必选 参数类型 描述 name 是 String 媒资分类名称。 id 是 Integer 媒资分类ID。

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 name String 媒资分类名称。 parent_id Integer 父分类ID。 一级分类父ID为0。 id Integer 媒资分类ID。 level Integer 媒资分类层级。 取值如下： 1：一级分类层级。 2：二级分类层级。 3：三级分类层级。 projectId String 项目ID。 状态码：400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求示例 创建媒资，使用存量托管方式。将已存储在OBS桶中的音视频文件同步到点播服务 POST https://{endpoint}/v1.0/{project_id}/asset/obs/host/stock/taskContent-Type: application/json{ "bucket": "obs-gg", "object": "1/Shoushu_FLV.flv", "suffix": [], "template_group_name": "original_template_group", "host_type": 1, "output_bucket": "obs-gg", "output_path": "ouput/"}

请求参数 表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参数 参数 是否必选 参数类型 描述 bucket 是 String 源桶名。 object 是 String 源目录名或源文件名。 suffix 否 Array of strings 批量托管时的文件后缀名列表。不传或传空值时，表示托管所有音视频文件，不进行后缀名过滤。 template_group_name 否 String 转码模板组名称。 若不为空，则使用指定的转码模板对上传的音视频进行转码，您可以在视频点播控制台配置转码模板，具体请参见转码设置。 说明： 若同时设置了“template_group_name”和“workflow_name”字段，则“template_group_name”字段生效。 workflow_name 否 String 工作流名称。 若不为空，则使用指定的工作流对上传的音视频进行处理，您可以在视频点播控制台配置工作流，具体请参见《点播服务用户指南》中的“工作流设置”。 host_type 否 Integer 表示音视频处理后生成的媒资文件所存储的位置类型。 取值如下所示： 0：表示存储到点播桶。 1：表示存储在租户桶。 2：表示存储到租户桶，并且存储路径与源文件一致。 output_bucket 否 String 输出桶名，host_type为1时必选 output_path 否 String 输出路径名，host_type为1时必选

请求示例 预热媒资，按照媒资ID进行预热 POST https://{endpoint}/v1.0/{project_id}/asset/preheatingContent-Type: application/json{ "asset_id": "f488337c31c8e4622f1590735b134c65"} 预热媒资，按照媒资URL进行预热 POST https://{endpoint}/v1.0/{project_id}/asset/preheatingContent-Type: application/json{ "urls": [ " https://example.com/asset/9db42f5e08c15edecd99a98da241994a/313bfd52a75f95ff48e8bf02eca2ab20.flv", " https://example.com/asset/9e455adb02295aa123809e8dc7ca51c1/68b1241af3bf58bcde9914626e07f5af.mp4", " https://example.com/asset/9e455adb02295aa123809e8dc7ca51c1/play_video/68b1241af3bf58bcde9914626e07f5af_H.264_480X270_HEAACV1_300.mp4" ]}