更新时间:2024-10-08 GMT+08:00

确认媒资上传

功能介绍

媒资分段上传完成后,需要调用此接口通知点播服务媒资上传的状态,表示媒资上传创建完成。

URI

POST /v1.0/{project_id}/asset/status/uploaded

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方法请参考获取项目ID

请求参数

表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,仅支持查询,不支持修改。

status

String

上传状态。

取值如下:

  • CREATED:创建成功。

  • FAILED:创建失败。

  • CANCELLED:创建取消。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

asset_id

String

VOD分配的媒资ID,仅支持查询,不支持修改。

状态码: 403

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

通知点播服务媒资上传的状态

POST https://{endpoint}/v1.0/{project_id}/asset/status/uploaded

Content-Type: application/json
{
  "asset_id": "f488337c31c8e4622f1590735b134c65",
  "status": "CREATED"
}

响应示例

状态码: 200

处理成功返回。

{
  "asset_id" : "f488337c31c8e4622f1590735b134c65"
}

状态码: 403

处理失败返回。

{
  "error_code" : "VOD.10062",
  "error_msg" : "Media asset or resource does not exist, please check."
}

状态码

状态码

描述

200

处理成功返回。

403

处理失败返回。

错误码

请参见错误码