云服务器内容精选

  • 响应示例 状态码: 200 处理成功返回。 { "total" : 1, "assets" : [ { "asset_id" : "67d1470893419bfcb9663103dd8a66ac", "title" : "video.mp4", "duration" : 60, "size" : 12881945, "category" : "其他", "covers" : [ { "cover_url" : "https://355.cdn-vod.huaweicloud.com/asset/67d1470893419bfcb9663103dd8a66ac/cover/Cover0.jpg" } ], "create_time" : "20190625020756", "asset_status" : "PUBLISHED", "transcode_status" : "TRANSCODE_SUCCEED", "thumbnail_status" : "UN_THUMBNAIL", "review_status" : "UN_REVIEW", "exec_desc" : "asset_exec_desc:Asset meta is\npublished;transcode_exec_desc:Transcode success;", "media_type" : "MP4" } ] } 状态码: 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参数 参数 参数类型 描述 total Integer 媒资总数 说明: 暂只能统计2万个媒资,若您需要查询具体的媒资总数,请提交工单申请。 assets Array of AssetSummary objects 媒资列表 表5 AssetSummary 参数 参数类型 描述 asset_id String VOD分配的媒资ID,仅支持查询,不支持修改。 title String 媒资标题。长度不超过128个字节,UTF-8编码。 description String 媒资描述。长度不超过1024个字节。 duration Integer 媒资时长。 单位:秒。 size Long 媒资大小。 单位:字节。 original_url String 原始播放url。 category String 媒资分类名称。 covers Array of CoverInfo objects 封面信息。 create_time String 媒资创建时间。 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间。 asset_status String 媒资状态。 取值如下: CREATING:上传中。 FAILED:上传失败。 CREATED:上传成功。 PUBLISHED:已发布。 DELETED:已删除。 transcode_status String 转码状态。 取值如下: UN_TRANSCODE:未转码。 WAITING_TRANSCODE:待转码 TRANSCODING:转码中。 TRANSCODE_SUCCEED:转码成功。 TRANSCODE_FAILED:转码失败。 thumbnail_status String 截图状态。 取值如下: UN_THUMBNAIL:未截图。 THUMBNAILING:截图中。 THUMBNAIL_SUCCEED:截图成功。 THUMBNAIL_FAILED:截图失败。 review_status String 内容审核 状态 取值如下: UN_REVIEW:未审核。 REVIEWING:审核中。 REVIEW_SUSPICIOUS:审核可疑,需要人工复审。 REVIEW_PASSED:审核通过。 REVIEW_FAILED:审核失败。 REVIEW_BLOCKED:已屏蔽。 exec_desc String 媒资的任务执行描述汇总。 示例: asset_exec_desc: upload success,媒资任务执行描述信息。 transcode_exec_desc: transcode success,转码任务执行描述信息。 thumbnail_exec_desc: thumbnail failed,截图任务执行描述信息。 review_exec_desc: review pass,审核任务执行描述信息。 media_type String 音视频文件的格式。 取值如下: 视频文件格式:MP4、TS、MOV、MXF、MPG、FLV、WMV、AVI、M4V、F4V、MPEG、WEBM 音频文件格式:MP3、OGG、WAV、WMA、APE、FLAC、AAC、AC3、MMF、AMR、M4A、M4R、WV、MP2 表6 CoverInfo 参数 参数类型 描述 cover_url String 封面文件的下载地址。 状态码: 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。
  • URI GET /v1.0/{project_id}/asset/list 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 asset_id 否 Array of strings 媒资ID,最多同时查询10个。 status 否 Array of strings 媒资状态,同时查询多个状态的媒资。 取值如下: CREATING:上传中 FAILED:上传失败 CREATED:上传成功 PUBLISHED:已发布 TRANSCODING:转码中 TRANSCODE_SUCCEED:转码成功 TRANSCODE_FAILED:转码失败 THUMBNAILING:截图中 THUMBNAIL_SUCCEED:截图成功 THUMBNAIL_FAILED:截图失败 UN_REVIEW:未审核 REVIEWING:审核中 REVIEW_SUSPICIOUS :审核不过,待人工复审 REVIEW_PASSED:审核通过 REVIEW_FAILED:审核任务失败 REVIEW_BLOCKED:已屏蔽 start_time 否 String 起始时间。 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间。 end_time 否 String 结束时间。 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间。 category_id 否 Integer 分类ID。 tags 否 String 媒资标签。 单个标签不超过24个字节, 最多不超过16 个标签。 多个用英文逗号分隔,UTF8编码。 query_string 否 String 在媒资标题、 描述、分类名称中模糊查询的字符串。 media_type 否 Array of strings 音视频文件的格式,支持多格式查询,最多不超过20个。 取值如下: 视频文件格式:MP4、TS、MOV、MXF、MPG、FLV、WMV、AVI、M4V、F4V、MPEG、WEBM 音频文件格式:MP3、OGG、WAV、WMA、APE、FLAC、AAC、AC3、MMF、AMR、M4A、M4R、WV、MP2 page 否 Integer 分页编号。 默认值:0。 size 否 Integer 每页记录数。 取值范围:[1,100]。 默认值:10。
  • 添加字幕 您可以为音视频文件添加格式为“SRT”,文字编码为“UTF-8”的字幕文件。字幕文件上传成功后,需要对音视频进行转码才能在音视频中压制对应字幕。 单击音视频所在行的“管理”,在“基本信息”页签单击“编辑”,进入基本信息编辑状态。 单击“上传字幕”,选择本地字幕文件上传。 单击“保存”后,关闭编辑状态。 勾选音视频,单击“转码”,重新转码压制字幕。 单击音视频所在行的“管理”,即可在“字幕与封面信息”页签获取到字幕文件URL。
  • 恢复归档文件 勾选一个或多个归档存储类型的音视频文件,单击“恢复归档文件”。 弹出“恢复已被归档的文件”,如图3所示。 图3 恢复已被归档的文件 参数配置说明,如表2所示。 表2 参数说明 参数 说明 恢复模式 归档存储恢复为标准存储的恢复模式。 包含如下选项: 快速取回模式:取回时间约为6分钟。 标准取回模式:取回时间约为3~5小时。 恢复方式 归档存储恢复为标准存储的恢复方式。 包含如下取值: 临时取回:临时取回音视频文件后,将会生成一份标准存储类型的对象副本。此时用户可以访问OBS的音视频文件资源,但是临时恢复的归档文件不允许执行转码操作。 该副本具备有效期,会在有效期结束后自动删除。实际音视频文件还是归档存储类型。 永久取回:永久取回音视频文件,变更为标准存储类型。 副本有效期 临时取回归档存储类型的音视频文件,生成标准存储类型对象副本的保存时间。 单位:天。取值范围:1-30。 单击“确定”,完成归档存储文件的恢复操作。 到达取回时间后,刷新音视频管理界面。 临时取回的方式,可以看到音视频的存储类型为“归档存储”。 永久取回的方式,可以看到音视频的存储类型为“标准存储”。
  • 查看媒资信息 您可以单击音视频所在行右侧的“管理”,查看下述信息。 基本信息 查看媒资名称,媒资ID,封面,字幕,时长,大小,上传时间,最近更新时间,类别,标签以及描述。若您的媒资属于OBS托管过来的,基本信息中还会有源路径和输出位置字段信息。 播放地址 查看原始文件以及转码后文件的清晰度,格式,视频编码格式,分辨率,码率,大小以及播放地址。 字幕与封面信息 若您为上传的文件添加了字幕和封面,可以在此页面查看其格式与地址。
  • 恢复归档文件 勾选一个或多个归档存储类型的音视频文件,单击“恢复归档文件”。 弹出“恢复已被归档的文件”,如图3所示。 图3 恢复已被归档的文件 参数配置说明,如表2所示。 表2 参数说明 参数 说明 恢复模式 归档存储恢复为标准存储的恢复模式。 包含如下选项: 快速取回模式:取回时间约为6分钟。 标准取回模式:取回时间约为3~5小时。 恢复方式 归档存储恢复为标准存储的恢复方式。 包含如下取值: 临时取回:临时取回音视频文件后,将会生成一份标准存储类型的对象副本。此时用户可以访问OBS的音视频文件资源,但是临时恢复的归档文件不允许执行转码操作。 该副本具备有效期,会在有效期结束后自动删除。实际音视频文件还是归档存储类型。 永久取回:永久取回音视频文件,变更为标准存储类型。 副本有效期 临时取回归档存储类型的音视频文件,生成标准存储类型对象副本的保存时间。 单位:天。取值范围:1-30。 单击“确定”,完成归档存储文件的恢复操作。 到达取回时间后,刷新音视频管理界面。 临时取回的方式,可以看到音视频的存储类型为“归档存储”。 永久取回的方式,可以看到音视频的存储类型为“标准存储”。