文档中心>智能媒资托管>业务级 API 文档>回收站操作接口>永久删除指定回收站项目(批量)

永久删除指定回收站项目(批量)

最近更新时间:2025-10-24 15:25:21

我的收藏

功能描述

用于永久删除指定回收站项目(批量)。
说明:
要求权限:admin、space_admin 或 delete_recycled。有关权限详情请参见 生成访问令牌接口
批量删除为高危操作,删除后不可逆。

请求

请求示例

POST /api/v1/recycled/{LibraryId}/{SpaceId}?delete&access_token={AccessToken}&user_id={UserId}

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
SpaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String
AccessToken
访问令牌,获取请参见 生成访问令牌
String
UserId
用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参阅 生成访问令牌接口
String

请求体

application/json,批量删除的 recycledItemId 集合。
请求体示例:
[ 1, 2, 3, 4, 5 ]
请求体为数组,必填参数。

响应

响应码

删除成功,返回 HTTP 204 No Content,删除失败,返回 HTTP 500 Internal Server Error。

响应体

该请求无响应体。

错误码

该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。