删除媒资下的多个截图 - DeleteThumbnails
功能介绍
删除媒资对应的截图,支持批量删除单个媒资下的多个截图结果,一次最多能删除十个。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
vod:thumbnail:delete
Write
assets *
vod:AssetLabel
-
-
URI
DELETE /v1/{project_id}/asset/thumbnails
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| asset_id | 否 | String | 媒资ID |
| task_id | 否 | Array of strings | 删除指定截图任务的截图结果,一次最多10个 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 否 | String | 用户Token,使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
| Authorization | 否 | String | 使用AK/SK方式认证时必选,携带的鉴权信息。 |
| X-Sdk-Date | 否 | String | 使用AK/SK方式认证时必选,请求的发生时间。 |
| X-Auth-Token | 是 | String | token |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| delete_result_array | Array of DeleteThumbnailResult objects | 删除截图信息的处理结果。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| asset_id | String | 删除截图结果对应的媒资id |
| task_id | String | 删除截图结果对应的任务id |
| status | String | 删除状态。 取值如下: |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码。 |
| error_msg | String | 错误描述。 |
请求示例
无
响应示例
状态码:200
处理成功返回。
{
"delete_result_array" : [ {
"task_id" : "2xxxxx30",
"status" : "DELETED"
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 处理成功返回。 |
| 400 | 处理失败返回。 |
错误码
请参见错误码。