华为云用户手册

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 delete_result_array Array of DeleteResult objects 删除媒资任务的处理结果。 表5 DeleteResult 参数 参数类型 描述 asset_id String VOD分配的媒资ID，仅支持查询，不支持修改。 status String 删除状态。 取值如下： DELETED：已删除。 FAILED：删除失败。 状态码： 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码： 200 处理成功返回。 { "delete_result_array" : [ { "asset_id" : "f488337c31c8e4622f1590735b134c65", "status" : "DELETED" } ] } 状态码： 403 处理失败返回。 { "error_code" : "VOD.10062", "error_msg" : "Media asset or resource does not exist, please check." }

响应示例 状态码： 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}." }

响应参数 状态码： 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 错误描述。

请求参数 表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.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时该参数无效。

请求参数 表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.1/{project_id}/asset/authority 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 http_verb 是 String 分段上传时调用OBS接口的HTTP方法，具体操作需要的HTTP方法请参考OBS的接口文档。 初始化上传任务：POST 上传段：PUT 合并段：POST 取消段：DELETE 列举已上传段：GET bucket 是 String 桶名。 调用创建媒资：上传方式接口中返回的响应体中的target字段获得的bucket值。 object_key 是 String 对象名。 调用创建媒资：上传方式接口中返回的响应体中的target字段获得的object值。 content_type 否 String 文件类型对应的content-type，当为上传任务初始化场景该字段必填。 参数填写可参考媒资分段上传（20M以上）。 视频文件：video/视频格式，如：“video/mp4” 音频文件：audio/音频格式，如：“audio/mp3” 图片文件：image/图片格式，如：“image/png” 字幕文件：application/octet-stream content_md5 否 String 上传段时每段的MD5。 upload_id 否 String 每一个上传任务的id，是OBS进行初始段后OBS返回的。除上传任务初始化场景外，该字段必填。 part_number 否 Integer 上传段时每一段的id。 取值范围：[1,10000]。

响应示例 状态码： 200 处理成功返回。 { "sign_str" : "https://obs.cn-north-4.myhuaweicloud.com:443/obs-vod-1/%7Bproject_id%7D/f488337c31c8e4622f1590735b134c65/Avatar_480P.mp4?AWSAccessKeyId=CBN2JOVSQVVUREU0R CS N&Expires=1518147618&Signature=kZYh0hEos2VJhjjdHC2zVAHGyXA%3D" } 状态码： 403 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

请求示例 初始化上传任务： GET https://{endpoint}/v1.1/{project_id}/asset/authority?http_verb=POST&content_type={type}&bucket={bucket}&object_key={objectKey} 上传段： GET https://{endpoint}/v1.1/{project_id}/asset/authority?http_verb=PUT&content_md5={md5}&part_number={num}&upload_id={id}&bucket={bucket}&object_key={objectKey} 合并段： GET https://{endpoint}/v1.1/{project_id}/asset/authority?http_verb=POST&upload_id={id}&bucket={bucket}&object_key={objectKey} 取消段： GET https://{endpoint}/v1.1/{project_id}/asset/authority?http_verb=DELETE&bucket={bucket}&object_key={objectKey}&upload_id={uploadId} 列举已上传的段： GET https://{endpoint}/v1.1/{project_id}/asset/authority?http_verb=GET&bucket={bucket}&object_key={objectKey}&upload_id={uploadId}

功能介绍 客户端请求创建媒资时，如果媒资文件超过20MB，需采用分段的方式向OBS上传，在每次与OBS交互前，客户端需通过此接口获取到授权方可与OBS交互。 该接口可以获取初始化多段上传任务、上传段、合并段、列举已上传段、取消段合并的带有临时授权的URL，用户需要根据OBS的接口文档配置相应请求的HTTP请求方法、请求头、请求体，然后请求对应的带有临时授权的URL。 视频分段上传方式和OBS的接口文档保持一致，包括HTTP请求方法、请求头、请求体等各种入参，此接口的作用是为用户生成带有鉴权信息的URL（鉴权信息即query_str），用来替换OBS接口中对应的URL，临时给用户开通向点播服务的桶上传文件的权限。 调用获取授权接口时需要传入bucket、object_key、http_verb，其中bucket和object_key是由创建媒资：上传方式接口中返回的响应体中的target字段获得的bucket和object，http_verb需要根据指定的操作选择。

请求参数 表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参数 参数 参数类型 描述 sign_str String 带授权签名字符串的URL。具体调用示例请参见示例2：媒资分段上传（20M以上）。示例：https://{obs_domain}/{bucket}?AWSAccessKeyId={AccessKeyID}&Expires={ExpiresValue}&Signature={Signature} 状态码： 403 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务您正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： 1 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 否 使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 是 application/json Content-Length 请求body长度，单位为Byte。 否 3495 X-Project-Id project id，项目编号。请参考获取项目ID章节获取项目编号。 否 如果是专属云场景采用AK/SK认证方式的接口请求，或者多project场景采用AK/SK认证的接口请求，则该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。 否 使用Token认证时该字段必选。 注：以下仅为Token示例片段。 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 1 2 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，$ADMIN_PASS表示用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“cn-north-1”，您可以从地区和终端节点获取。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token的作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "$ADMIN_PASS", //建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxxx" } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中的“X-Subject-Token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点获取。 例如IAM服务在“华北-北京四”区域的Endpoint为“iam.cn-north-4.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“?”，形式为“参数名=参数取值”，例如“?limit=10”，表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京四”区域的Token，则需使用“华北-北京四”区域的Endpoint（iam.cn-north-4.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 1 https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为方便查看，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

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

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

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

响应示例 状态码： 200 处理成功返回。 { "top_urls" : [ { "value" : 0, "asset_id" : "548b6023bf2cc925bd64343f04ca0f88", "title" : "test", "duration" : 0, "size" : 0 } ] } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 top_urls Array of TopUrl objects 指定域名top100 URL集合 表5 TopUrl 参数 参数类型 描述 value Long 总播放次数。 asset_id String VOD分配的媒资ID，仅支持查询，不支持修改。 title String 媒资名称。 duration Integer 媒资时长。 单位：秒。 size Long 媒资原始大小。 单位：字节。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

URI GET /v1.0/{project_id}/asset/top-statistics 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 domain 是 String 查询域名，暂只支持查询单个或者全部域名。 取值如下： 单个加速域名，格式：example.test1.com。 ALL：表示查询名下全部域名。 date 是 String 查询日期，格式为yyyymmdd date必须为昨天或之前的日期。 最多只能查最近一个月内的数据。

URI GET /v1.0/{project_id}/asset/info 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 asset_id 否 Array 媒资id，最多同时查询10个媒资。 status 否 Array 媒资状态。 取值如下： UNCREATED：未创建（媒资ID不存在 ） DELETED：已删除 CANCELLED：上传取消 SERVER_ERROR：上传失败（点播服务端故障） UPLOAD_FAILED：上传失败（向OBS上传失败） CREATING：创建中 PUBLISHED：已发布 TRANSCODING：待发布（转码中） TRANSCODE_FAILED：待发布（转码失败） TRANSCODE_SUCCEED：待发布（转码成功） CREATED：待发布（未转码） transcodeStatus 否 Array 转码状态 取值如下： TRANSCODING：转码中 TRANSCODE_FAILED：转码失败 TRANSCODE_SUCCEED：转码成功 UN_TRANSCODE：未转码 WAITING_TRANSCODE：等待转码 assetStatus 否 Array 媒资状态。 取值如下： PUBLISHED：已发布 CREATED：未发布 start_time 否 String 起始时间，查询指定“asset_id”时，该参数无效。 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间。 end_time 否 String 结束时间，查询指定“asset_id”时，该参数无效。 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间。 category_id 否 Integer 分类ID。 tags 否 String 媒资标签。 单个标签不超过16个字节，最多不超过16个标签。 多个用逗号分隔，UTF8编码。 query_string 否 String 在媒资标题、描述中模糊查询的字符串。 page 否 Integer 分页编号，查询指定“asset_id”时，该参数无效。 默认值：0。 size 否 Integer 每页记录数，查询指定“asset_id”时，该参数无效。 取值范围：[1,100]。 默认值：10。

响应示例 状态码： 200 处理成功返回。 { "asset_info_array" : [ { "asset_id" : "652c1e4085afeb22fdc256c6757d751b", "status" : "PUBLISHED", "description" : "Asset meta is published", "is_multi_transcode" : false, "base_info" : { "title" : "okFLV.flv", "video_name" : "okFLV.flv", "description" : null, "category_id" : -1, "category_name" : "其他", "create_time" : "20190704144303", "last_modified" : "20190704144303", "video_type" : "FLV", "tags" : null, "meta_data" : { "pack_type" : null, "codec" : "H.264", "duration" : 244, "video_size" : 13682041, "width" : 512, "hight" : 288, "height" : 288, "bit_rate" : 448, "frame_rate" : 30, "quality" : null }, "video_url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/45c2493abe68de3dac7e98b0dadcf8ce.flv", "sign_url" : "", "cover_info_array" : [ { "cover_url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/cover/Cover0.jpg" } ], "subtitle_info" : [ ], "source_path" : { "bucket" : "obs-host", "location" : "cn-north-4", "object" : "1/okFLV.flv" }, "output_path" : { "bucket" : "obs-host", "location" : "cn-north-4", "object" : "output/652c1e4085afeb22fdc256c6757d751b/" } }, "play_info_array" : [ { "play_type" : "hls", "url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/play_video/index.m3u8", "encrypted" : 0, "meta_data" : { "pack_type" : null, "codec" : "H.264", "duration" : 0, "video_size" : 0, "width" : 0, "hight" : 0, "height" : 0, "bit_rate" : 0, "frame_rate" : 0, "quality" : null } }, { "play_type" : "hls", "url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/play_video/b5d498082bbcff7a2055041d803ae2f9_1.m3u8", "encrypted" : 0, "meta_data" : { "pack_type" : null, "codec" : "H.264", "duration" : 205, "video_size" : 14669824, "width" : 512, "hight" : 288, "height" : 288, "bit_rate" : 534, "frame_rate" : 0, "quality" : null } } ] } ], "is_truncated" : 0, "total" : 1 } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

请求示例 单媒资ID查询 GET /v1.0/{project_id}/asset/info?asset_id=652c1e4085afeb22fdc256c6757d751b 多媒资ID查询 GET /v1.0/{project_id}/asset/info?asset_id=652c1e4085afeb22fdc256c6757d751b&asset_id=xxxxxx&asset_id=xxxxxx 按时间段查询 GET /v1.0/{project_id}/asset/info?start_time=20170725181000&end_time=20170726181000&page=0&size=20 查询（当前租户下）所有媒资：最近创建的10个，page为默认值0，size为默认值10 GET /v1.0/{project_id}/asset/info 查询（当前租户下）所有媒资：最近创建的第21个到第40个 GET /v1.0/{project_id}/asset/info?page=1&size=20 按分类查询 GET /v1.0/{project_id}/asset/info?category_id=100

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

响应参数 状态码： 202 表4 响应Body参数 参数 参数类型 描述 preheating_results Array of PreheatingResult objects 预热任务数组 表5 PreheatingResult 参数 参数类型 描述 url String 媒资URL。 status String 预热任务状态。 取值如下： processing：处理中 succeed：预热完成 failed：预热失败 状态码： 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方式认证时必选，请求的发生时间。

响应示例 状态码： 202 处理成功返回。 { "preheating_results" : [ { "url" : "https://example.com/asset/9db42f5e08c15edecd99a98da241994a/313bfd52a75f95ff48e8bf02eca2ab20.flv", "status" : "processing" }, { "url" : "https://example.com/asset/9e455adb02295aa123809e8dc7ca51c1/68b1241af3bf58bcde9914626e07f5af.mp4", "status" : "succeed" }, { "url" : "https://example.com/asset/9e455adb02295aa123809e8dc7ca51c1/play_video/68b1241af3bf58bcde9914626e07f5af_H.264_480X270_HEAACV1_300.mp4", "status" : "failed" } ] } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }