# 删除转码产物 - DeleteTranscodeProduct #### 功能介绍 删除转码产物。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/VOD/doc?api=DeleteTranscodeProduct)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-vod/vod_04_0012.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | vod:asset:deleteTranscodeProduct | Write | assets \* | vod:AssetLabel | - | - | #### URI DELETE /v1/{project_id}/asset/transcode-product 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目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 | 媒资ID。 | | delete_type | 否 | String | GROUP：模板组级删除。 PRODUCT：产物级删除 | | delete_infos | 否 | Array of [ProductGroupInfo] objects | 删除的产物信息，最多传100个产物信息。 | 表4ProductGroupInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | group_id | 否 | String | 模板组ID | | products | 否 | Array of [ProductUrlInfo] objects | 产物信息 | 表5ProductUrlInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | url | 否 | String | 删除的产物URL | #### 响应参数 **状态码：200** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | asset_id | String | VOD分配的媒资ID，仅支持查询，不支持修改。 | | status | String | SUCCESS：成功 FAIL：失败 PARTIAL_SUCCESS：部分成功 | | deleted_products | Array of [ProductGroupInfo] objects | 删除成功的产物 | | failed_products | Array of [ProductGroupDelFailInfo] objects | 删除失败的产物 | 表7ProductGroupInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | group_id | String | 模板组ID | | products | Array of [ProductUrlInfo] objects | 产物信息 | 表8ProductUrlInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | url | String | 删除的产物URL | 表9ProductGroupDelFailInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | group_id | String | 模板组ID | | fail_reason | String | 模板组删除失败的原因 | | products | Array of [ProductDelFailInfo] objects | 删除失败的产物的信息 | 表10ProductDelFailInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | url | String | 删除产物的URL | | fail_reason | String | 删除产物失败的原因 | **状态码：403** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_msg | String | 错误描述。 | #### 请求示例 - ``` DELETE https://{endpoint}/v1/{project_id}/asset/transcode-product Content-Type: application/json { "asset_id": "8c53b4038ea3d8694f1a8a7ac95f612f", "delete_type": "PRODUCT", "delete_infos": [ { "group_id": "9171008cca7f47909c61f61a65d4c906", "products": [ { "url": "https://103-cn-north-4.cdn-vod.huaweicloud.com/asset/8c53b4038ea3d8694f1a8a7ac95f612f/play_multi_video/9171008cca7f47909c61f61a65d4c906/38a92b74ead764ad21aa5355bad5193e.mp4" } ] } ] } ``` - ``` DELETE https://{endpoint}/v1/{project_id}/asset/transcode-product Content-Type: application/json { "asset_id": "6f306b4cc58c39b2a97ad797367b88ad", "delete_type": "GROUP", "delete_infos": [ { "group_id": "02e6887dd6bf48299922eec52d192115" } ] } ``` #### 响应示例 **状态码：200** 处理成功返回。 ``` { "status" : "SUCCESS", "deleted_products" : [ { "group_id" : "9171008cca7f47909c61f61a65d4c906", "products" : [ { "url" : "https://103-cn-north-4.cdn-vod.huaweicloud.com/asset/8c53b4038ea3d8694f1a8a7ac95f612f/play_multi_video/9171008cca7f47909c61f61a65d4c906/da6613ac132eda54b2f4ab67adbf56bd.mp4" } ] } ], "failed_products" : [ ] } ``` **状态码：403** 处理失败返回。 ``` { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 处理成功返回。 | | 403 | 处理失败返回。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-vod/ErrorCode.html)。