恢复指定回收站项目

最近更新时间:2025-10-29 14:34:31

我的收藏

功能描述

用于恢复指定回收站项目。
说明:
要求权限:admin、space_admin 或 restore_recycled。有关权限详情可参考 生成访问令牌接口
恢复项目时需保证该项目所在的目录存在。

请求

请求示例

POST /api/v1/recycled/{LibraryId}/{SpaceId}/{RecycledItemId}?restore&conflict_resolution_strategy={ConflictResolutionStrategy}&access_token={AccessToken}&user_id={UserId}&restore_path_strategy={RestorePathStrategy}

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
SpaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String
RecycledItemId
回收站项目 ID,获取请参见 列出回收站项目
String
ConflictResolutionStrategy
文件名冲突时的处理方式,默认为 rename
ask:冲突时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码
rename:冲突时自动重命名文件
overwrite:
如果目标为目录或相簿时,默认为 ask 且不支持 overwrite
如果目标为文件,覆盖已有文件
当目标空间的文件存在历史版本时,不支持移动覆盖
String
AccessToken
访问令牌,获取请参见 生成访问令牌
String
UserId
用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参见 生成访问令牌接口
String
RestorePathStrategy
恢复项目源路径的处理方式
originalPath:恢复到原始路径,原始路径不存在则报错
fallbackToRoot:恢复到原始路径,原始路径不存在则恢复到根目录
默认为 originalPath
String

请求体

该请求无请求体。

响应

响应码

恢复成功,返回 HTTP 200 OK。

响应体

application/json
响应体示例:
{ "path": [ "foo", "bar", "file (1).docx" ] }
响应体字段说明:
响应参数
描述
类型
path
表示最终的文件路径
String Array

错误码

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