状态码： 403 处理失败返回。
{ "error_code" : "VOD.10053",
"error_msg" : "The request parameter is illegal, illegal field: {xx}."
}
状态码
状态码 描述
200 处理成功返回。
403 处理失败返回。
错误码
请参见错误码。
8.3 查询托管媒资详情
功能介绍
查询OBS托管媒资的详细信息。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1.0/{project_id}/asset/obs/host/task/details
表8-20 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID，获取方法请参考获取项 目ID
表8-21 Query 参数
参数 是否必选 参数类型 描述
source_bucket 是 String 媒资原始输入存放的桶。
source_object 是 String 媒资原始输入的objectKey。
请求参数
表8-22 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 否 String 用户Token，使用Token鉴权方 式时必选。
通过调用IAM服务获取用户 Token接口获取（响应消息头中 X-Subject-Token的值）。
Authorization 否 String 使用AK/SK方式认证时必选，携 带的鉴权信息。
X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请 求的发生时间。
响应参数
状态码： 200
表8-23 响应 Body 参数
参数 参数类型 描述
asset_id String 媒资ID。
asset_status String 媒资状态。
● "CREATING"：上传中
● "FAILED"：上传失败
● "CREATED"：上传成功
● "PUBLISHED"：已发布
● "DELETED"：已删除
参数 参数类型 描述 transcode_sta
tus String 转码状态。
● "UN_TRANSCODE"：未转码
● "WAITING_TRANSCODE"：等待转码，排队 中
● "TRANSCODING"：转码中
● "TRANSCODE_SUCCEED"：转码成功
● "TRANSCODE_FAILED"：转码失败 base_info BaseInfo
object 媒资基本信息。
transcode_inf
o TranscodeInf
o object 转码生成文件信息。
说明
仅当转码成功后才能查询到此信息，未转码、正在转码 以及转码失败时，无此字段信息。
表8-24 BaseInfo
参数 参数类型 描述
title String 媒资标题。
长度不超过128个字节，UTF8编码。
video_name String 媒资文件名。
description String 媒资描述。
长度不超过1024个字节。
category_id Long 媒资分类id。
category_nam
e String 媒资分类名称。
create_time String 媒资创建时间。
格式为yyyymmddhhmmss。必须是与时区无关 的UTC时间。
last_modified String 媒资最近修改时间。
格式为yyyymmddhhmmss。必须是与时区无关 的UTC时间。
参数 参数类型 描述
video_type String 音视频文件类型。
取值如下：
● 视频文件：MP4、TS、MOV、MXF、MPG、
FLV、WMV、AVI、M4V、F4V、MPEG、
3GP、ASF、MKV。
● 音频文件：MP3、OGG、WAV、WMA、
APE、FLAC、AAC、AC3、MMF、AMR、
M4A、M4R、WV、MP2。
tags String 媒资标签。
单个标签不超过16个字节，最多不超过16个标 签。
多个用逗号分隔，UTF8编码。
meta_data MetaData
object 视频的元数据信息。
经过视频解析后产生，包括封装格式、大小、分 辨率、码率、帧率。
video_url String 原始视频文件的访问地址。
cover_info_arr
ay Array of CoverInfo objects
封面信息。
subtitle_info Array of SubtitleInfo objects
字幕信息数组
source_path File_addr
object 媒资存储参数信息。
output_path File_addr
object 媒资存储参数信息。
表8-25 MetaData
参数 参数类型 描述
codec String 视频编码格式。
取值如下：
● Vorbis
● AAC
● WavPack duration Long 视频时长。
若视频的原时长为非整数，则该字段值为原时长 的向上取整。
video_size Long 视频文件大小。
单位：字节。
width Long 视频宽度（单位：像素）。
● 编码为H.264的取值范围：[32,3840]之间2的 倍数。
● 编码为H.265的取值范围：[320,3840]之间4的 倍数。
hight Long 视频高度（单位：像素）。
● 编码为H.264的取值范围：[32,2160]之间2的 倍数 。
● 编码为H.265的取值范围：[240,2160]之间4的 倍数。
bit_rate Long 视频平均码率。
参数 参数类型 描述
frame_rate Long 帧率（单位：帧每秒）。
取值如下：
● FRAMERATE_AUTO = 1,
● FRAMERATE_10 = 2,
● FRAMERATE_15 = 3,
● FRAMERATE_2397 = 4, // 23.97 fps
● FRAMERATE_24 = 5,
● FRAMERATE_25 = 6,
● FRAMERATE_2997 = 7, // 29.97 fps
● FRAMERATE_30 = 8,
● FRAMERATE_50 = 9,
● FRAMERATE_60 = 10 默认值：1。
单位：帧每秒。
quality String 清晰度。
取值如下：
● FULL_HD：超高清
● HD：高清
● SD：标清
● FLUENT：流畅
● AD：自适应
● 2K
● 4K audio_channe
ls Integer 音频的声道数。
表8-26 CoverInfo
参数 参数类型 描述
cover_url String 封面文件的下载地址。
表8-27 SubtitleInfo
参数 参数类型 描述
url String 字幕文件的下载地址
参数 参数类型 描述 id Integer 字幕文件id
type String 字幕文件类型
language String 字幕文件语言种类
表8-28 File_addr
参数 参数类型 描述
bucket String OBS的bucket名称。
location String 桶所在的区域名， 如“华北-北京四”的区域名 为“cn-north-4”，创建的桶所在区域必须和点 播服务所在区域保持一致。
object String 文件的存储路径。
表8-29 TranscodeInfo
参数 参数类型 描述
template_gro
up_name String 转码模板组名称。
output Array of Output objects
转码输出数组。
● HLS或DASH格式：此数组的成员个数为n+1，
n为转码输出路数。
● MP4格式：此数组的成员个数为n，n为转码输 出路数。
exec_desc String 执行情况描述。
transcode_sta
tus String 转码状态。
取值如下：
● UN_TRANSCODE：未转码
● WAITING_TRANSCODE：待转码
● TRANSCODING：转码中
● TRANSCODE_SUCCEED：转码成功
● TRANSCODE_FAILED：转码失败
表8-30 Output
参数 参数类型 描述
play_type String 协议类型。
取值如下：
● hls
● dash
● mp4 url String 播放URL。
encrypted Integer 标记流是否已被加密。
取值如下：
● 0：表示未加密。
● 1：表示已被加密。
quality String 清晰度。
取值如下：
● FLUENT：流畅
● SD：标清
● HD：高清
● FULL_HD：超清 meta_data MetaData
object 视频的元数据信息。
经过视频解析后产生，包括封装格式、大小、分 辨率、码率、帧率。
状态码： 403
表8-31 响应 Body 参数
参数 参数类型 描述
error_code String 错误码。
error_msg String 错误描述。
请求示例
GET https://{endpoint}/v1.0/{project_id}/asset/obs/host/task/details?
source_bucket={source_bucket}&source_object={source_object}
响应示例
状态码： 200 处理成功返回。
{ "asset_id" : "41cff636d5b12a51e7eb2838bbf45201", "base_info" : {
"title" : "Avatar",
"video_name" : "视频点播 VOD 视频.mp4",
"description" : "Avatar, marketed as James Cameron's Avatar, is a 2009 American\nepic science fiction film directed, written, produced, and\nco-edited by James Cameron",
"category_id" : -1, "category_name" : "其他", "create_time" : "20190612032250", "last_modified" : "20190613075030", "video_type" : "MP4",
"tags" : "test1,test2", "meta_data" : {
"video_url" : "https://355.cdn-vod.huaweicloud.com/asset/
41cff636d5b12a51e7eb2838bbf45201/5597e59de70722eaeb9b18c274e249b2.mp4", "cover_info_array" : [ {
"cover_url" : "https://355.cdn-vod.huaweicloud.com/asset/41cff636d5b12a51e7eb2838bbf45201/cover/
Cover0.jpg"
} ]
}, "transcode_info" : {
"template_group_name" : "system_template_group", "output" : [ {
"play_type" : "HLS",
"url" : "https://355.cdn-vod.huaweicloud.com/asset/41cff636d5b12a51e7eb2838bbf45201/play_video/
index.m3u8",
"url" : "https://355.cdn-vod.huaweicloud.com/asset/41cff636d5b12a51e7eb2838bbf45201/play_video/视 频点播\nVOD 视频_1_854X480_600_0.m3u8",
"encrypted" : 0,
"url" : "https://355.cdn-vod.huaweicloud.com/asset/41cff636d5b12a51e7eb2838bbf45201/play_video/
index.mpd", "encrypted" : 0,
"meta_data" : {
"exec_desc" : "Transcode success",
"transcode_status" : "TRANSCODE_SUCCEED"
}}
状态码： 403 处理失败返回。
{ "error_code" : "VOD.10064",
"error_msg" : "Media asset classification does not exist, please check."
}
9 媒资预热
9.1 CDN预热