功能描述
用于复制目录或相簿。
请求
请求示例
PUT /api/v1/directory/{LibraryId}/{SpaceId}/{DirPath}?conflict_resolution_strategy={ConflictResolutionStrategy}&access_token={AccessToken}&user_id={UserId}
请求参数
请求参数 | 描述 | 类型 | 是否必选 |
LibraryId | String | 是 | |
SpaceId | String | 否 | |
DirPath | 目标目录路径或相簿名。 对于多级目录,使用斜杠( /)分隔,例如 foo/bar_new | String | 是 |
ConflictResolutionStrategy | 最后一级目录冲突时的处理方式,默认为 ask: ask: 冲突时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码 rename: 冲突时自动重命名最后一级目录 | String | 否 |
AccessToken | String | 是 | |
UserId | String | 否 |
请求体
application/json,指定被复制的源目录路径或相簿名。
请求体示例:
{"copyFrom": "foo/bar"}
请求体字段说明:
请求参数 | 描述 | 类型 | 是否必选 |
copyFrom | 被复制的源目录或相簿路径 | String | 是 |
响应
响应码
复制成功,返回 HTTP 202 Accepted。
响应体
空,无响应体(返回 HTTP 204 No Content)或 application/json(返回 HTTP 200 OK 或 HTTP 202 Accepted)。
响应体示例:
返回 HTTP 200 OK 时:
{ "path": [ "foo", "bar (1)" ] }
返回 HTTP 202 Accepted 时:
{ "taskId": 10 }
[{"id": 10,"status": 200,"result": { "path": [ "foo", "bar (1)" ] }}]
响应体字段说明:
响应参数 | 描述 | 类型 |
path | 表示最终的目录或相簿路径,因为可能存在自动重命名,所以这里的最终路径可能不等同于复制目录或相簿时指定的路径 | Array |
taskId | 异步方式复制时的任务 ID,可通过查询任务接口查询任务状态 | String |