智能媒资托管 批量恢复回收站项目
参与社区的环保项目,如回收站管理 #生活乐趣# #日常生活乐趣# #环保生活实践# #户外自然探索#
批量恢复回收站项目
最近更新时间:2024-10-15 18:47:42
功能描述
用于恢复指定回收站项目(批量)。
接口说明
要求权限:
非 acl 鉴权:admin、space_admin 或 restore_recycled。
acl 鉴权:admin、space_admin。
说明
非 acl 鉴权是指当前用户对所有文件的操作权限,详情可参考 生成访问令牌接口。
acl 鉴权是通过共享授权接口给指定用户,以文件夹为单位授予的权限,详情可参考 角色授权模块。
恢复项目时需保证该项目所在的目录存在。
请求
请求示例
POST /api/v1/recycled/{LibraryId}/{SpaceId}?restore&access_token={AccessToken}&user_id={UserId}
请求参数:
LibraryId:媒体库 ID,必选参数。
SpaceId:空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(-);如果媒体库为多租户模式,则必须指定该参数。
AccessToken:访问令牌,必选参数。
UserId:用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参阅 生成访问令牌接口,可选参数。
请求体
application/json,批量恢复的 recycledItemId 集合。
请求体示例:
请求体为数组,必填参数。
响应
响应码
执行成功
当项目较多以异步方式恢复时,返回 HTTP 202 Accepted。
当项目较少以同步方式恢复时,返回 HTTP 200 OK(全部执行成功)或 HTTP 207 Multi-Status(存在部分或全部执行失败)。
响应体
application/json
响应体示例: 返回 HTTP 200 OK 或 HTTP 207 Multi-Status 时:
{
"result": [
{
"status": 200,
"path": [ "foo", "bar", "file (1).docx" ],
"recycledItemId": 1
},
{
"status": 404,
"code": "RecycledItemNotFound",
"message": "Recycled item not found.",
"recycledItemId": 2
},
{
"status": 404,
"code": "DirectoryNotFound",
"message": "Directory not found.",
"recycledItemId": 3
},
{
"status": 409,
"code": "SameNameDirectoryOrFileExists",
"message": "A directory or file with the same name already exists.",
"recycledItemId": 4
},
{
"status": 404,
"code": "SourceFileNotFound",
"message": "Source file not found.",
"recycledItemId": 5
}
]
}
返回 HTTP 202 Accepted 时:
查询批量恢复任务响应体:
[
{
"id": 20,
"status": 200,
"result": [
{ "status": 200, "path": [ "foo", "bar", "file (2).docx" ], "recycledItemId": 6 }
]
}
]
响应体字段说明:
result.status:200:恢复成功,其他:恢复失败。
result.path:字符串数组,表示最终的文件路径。
result.recycledItemId:发起请求时传入的回收站项目 ID。
taskId:异步方式恢复时的任务 ID,可通过查询任务接口查询任务状态。
查询任务响应体字段说明:
status:202:任务进行中,200:全部执行成功,207:存在部分或全部执行失败。
网址:智能媒资托管 批量恢复回收站项目 https://www.yuejiaxmz.com/news/view/681406
相关内容
智能媒资托管 列出回收站项目回收站删除了怎么恢复 回收站删除了恢复方法
怎么从回收站恢复已删除的文件?(5种恢复方法)
如何恢复回收站的误删
智能自助垃圾回收站项
关于寿县生活垃圾中转站项目建议书的批复
电脑回收站清空后恢复教程
如何进行回收站数据恢复
投标=天津建能节能科技有限公司供暖能源站托管G8项目竞争性磋商
Win10回收站清空了怎么办?Win10如何恢复回收站删除的文件