视频更新
功能介绍
媒资创建后，单独上传封面、更新视频文件或更新已有封面。如果是更新视频文件，更新完后要通过确认媒资上传接口通知点播服务。如果是更新封面或单独上传封面，则不需通知。更新视频可以使用分段上传，具体方式可以参考示例2：媒资分段上传（20M以上）。
接口约束
视频更新接口只支持更新下载失败、已取消和上传失败状态的媒资
请求Body参数的设置要求，如下所示：
-
参数video_name、cover_type、subtitles必须至少设置一个。
-
如果更新视频，参数video_name、video_type为必填项，不能为空值。
-
如果更新封面，参数cover_type为必填项，不能为空值，如果携带cover_id，则必须填0。
-
如果上传字幕文件，参数subtitles的id、type和language为必填项，不能为空值。
如果未按照上述要求设置参数，将无法正常返回接口响应消息。
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
否 |
String |
用户Token，使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
|
Authorization |
否 |
String |
使用AK/SK方式认证时必选，携带的鉴权信息。 |
|
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选，请求的发生时间。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
封面图片格式类型。 取值如下：
|
|
cover_md5 |
否 |
String |
封面文件的MD5值。 |
|
subtitles |
否 |
Array of Subtitle objects |
字幕文件信息 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
asset_id |
String |
VOD分配的媒资ID，仅支持查询，不支持修改。 |
|
video_upload_url |
String |
视频上传地址。 用于客户端上传不超过20MB的小视频文件（<=20MB）。该URL中携带了临时授权信息，当文件大于20MB时，需要采用分段方式上传。
说明：
您可以使用PUT请求向“video_upload_url”中上传视频文件。其中，“Content-Type”需要根据上传的视频文件类型进行设置，如下所示：视频文件：video/视频格式，如：“video/mp4”。 |
|
cover_upload_url |
String |
封面上传地址，用于上传封面文件。
说明：
您可以使用PUT请求向“cover_upload_url”中上传封面图片。其中，“Content-Type”需要根据上传的封面文件类型进行设置，如下所示：图片文件：image/图片格式，如：“image/png”。 |
|
subtitle_upload_urls |
Array of strings |
字幕上传地址，用于上传字幕。
说明：
您可以使用PUT请求向“subtitle_upload_urls”中上传字幕文件。其中，“Content-Type”需要根据上传的字幕文件类型进行设置，如下所示：字幕文件：application/octet-stream。 |
状态码： 403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
错误描述。 |
请求示例
更新媒资
PUT https://{endpoint}/v1.0/{project_id}/asset
Content-Type: application/json
{
"asset_id": "f488337c31c8e4622f1590735b134c65",
"cover_id": "0",
"cover_type": "JPG",
"subtitles": [
{
"id": 1,
"language": "CN",
"type": "SRT",
"md5": "SqcyFjJZoDZaP8oKIY6rgQ==",
"description": "AAAAA"
}
]
}
响应示例
状态码： 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**********0RCSN&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."
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
处理成功返回。 |
|
403 |
处理失败返回。 |
错误码
请参见错误码。
