产品概述
功能介绍
产品优势
应用场景
基本概念
POST /api/v1/batch/{LibraryId}/{SpaceId}?move&access_token={AccessToken}&user_id={UserId}
[{"fromSpaceId":"spaceNJsnjdiq","from": "foo/bar_old","to": "foo/bar"},{"from": "foo/1.jpg","to": "bar/1.jpg"},{"from": "foo/2.jpg","to": "bar/2.jpg","conflictResolutionStrategy": "overwrite"}]
请求参数 | 描述 | 类型 | 是否必选 |
fromSpaceId | 跨空间移动时指定源目录或文件所在的空间，同空间移动时请勿指定该字段 | String | 否 |
from | 被重命名或移动的源目录、相簿或文件路径 | String | 是 |
to | 目标目录、相簿或文件路径 | String | 是 |
conflictResolutionStrategy | 文件名冲突时的处理方式，默认为 rename ask：冲突时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码 rename：冲突时自动重命名文件 overwrite： 如果目标为目录或相簿时，默认为 ask 且不支持 overwrite 如果目标为文件，覆盖已有文件 当目标空间的文件存在历史版本时，不支持移动覆盖 | String | 否 |
moveAuthority | 是否允许移动 | Boolean | 否 |
{"result": [{"status": 204,"moveAuthority":false,"from": [ "foo", "bar_old" ],"to": [ "foo", "bar" ]},{"status": 200,"path": [ "bar", "1 (1).jpg" ],"from": [ "foo", "1.jpg" ],"to": [ "bar", "1.jpg" ]},{"status": 204,"from": [ "foo", "2.jpg" ],"to": [ "bar", "2.jpg" ]}]}
{ "taskId": 17 }
[{"taskId": 17,"status": 200,"result": [{"status": 204,"moveAuthority":false,"from": [ "foo", "bar_old" ],"to": [ "foo", "bar" ]},{"status": 200,"path": [ "bar", "1 (1).jpg" ],"from": [ "foo", "1.jpg" ],"to": [ "bar", "1.jpg" ]},{"status": 204,"from": [ "foo", "2.jpg" ],"to": [ "bar", "2.jpg" ]}]}]
响应参数 | 描述 | 类型 |
result.status | 单个项目的重命名或移动结果： 200：conflictResolutionStrategy 为 rename 时重命名或移动成功 204：conflictResolutionStrategy 为 ask 或 overwrite 时重命名或移动成功 403/404/409/500等：重命名或移动失败 | String |
result.moveAuthority | 是否允许移动 | Boolean |
result.path | 表示最终的路径，因为可能存在自动重命名，所以这里的最终路径可能不等同于重命名或移动时指定的路径 | String Array |
result.from 和 result.to | 发起请求时传入的对应路径的数组形式 | Array |
taskId | 异步方式重命名或移动时的任务 ID，可通过查询任务接口查询任务状态 | String |
响应参数 | 描述 | 类型 |
status | 查询任务状态： 202：任务进行中 200：全部执行成功 207：存在部分或全部执行失败 | String |
文档反馈