更新时间：2024-11-19 GMT+08:00
删除媒资
功能介绍
删除媒资。
接口约束
正在处理中的媒资不支持删除，包括转码中、审核中、截图中等。
URI
DELETE /v1.0/{project_id}/asset
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID，获取方法请参考获取项目ID |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
asset_id |
是 |
Array of strings |
媒资ID，支持一次删除多个媒资，批量删除时以逗号分隔。取值范围[1,10]。 |
|
delete_type |
否 |
String |
删除类型，当值为origin时只删除源文件，保留转码后文件，不填的话走默认删除整个媒资。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
否 |
String |
用户Token，使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
|
Authorization |
否 |
String |
使用AK/SK方式认证时必选，携带的鉴权信息。 |
|
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选，请求的发生时间。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
delete_result_array |
Array of DeleteResult objects |
删除媒资任务的处理结果。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
asset_id |
String |
VOD分配的媒资ID，仅支持查询，不支持修改。 |
|
status |
String |
删除状态。 取值如下：
|
状态码： 403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
错误描述。 |
请求示例
删除媒资
DELETE https://{endpoint}/v1.0/{project_id}/asset?asset_id={asset_id}
响应示例
状态码： 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 |
处理成功返回。 |
|
403 |
处理失败返回。 |
错误码
请参见错误码。
父主题： 媒资管理
