功能描述
用于重命名或移动目录或相簿。
说明:
要求权限:非 acl 鉴权:admin、space_admin 或 move_directory。有关权限详情请参见 生成访问令牌接口。
该接口的源和目标均需要指定完整的目录路径或相簿名,对于文件类型媒体库,源与目标可以跨越多层级多目录,来实现将目录移动到任意其他父目录下的功能,且支持同时修改目录名。
自动创建中间所需的各级父目录。
请求
请求示例
PUT /api/v1/directory/`{LibraryId}`/`{SpaceId}`/`{DirPath}`?conflict_resolution_strategy=`{ConflictResolutionStrategy}`&move_authority=`{MoveAuthority}`&access_token=`{AccessToken}`&user_id=`{UserId}`
请求参数
请求参数 | 描述 | 类型 | 是否必选 |
LibraryId | String | 是 | |
SpaceId | 空间 ID 如果媒体库为单租户模式,则该参数固定为连字符(-) 如果媒体库为多租户模式,则该参数为 创建租户空间 接口返回的空间 ID | String | 是 |
DirPath | 目标目录路径或相簿名 | String | 是 |
ConflictResolutionStrategy | 最后一级目录冲突时的处理方式,默认为 ask: ask: 冲突时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码 rename: 冲突时自动重命名最后一级目录 | String | 否 |
AccessToken | String | 是 | |
UserId | String | 否 |
请求体
application/json,指定被重命名或移动的源目录路径或相簿名。
请求体示例:
{"from": "foo/bar_old"}
请求体字段说明:
请求参数 | 描述 | 类型 | 是否必选 |
from | 被重命名或移动的源目录或相簿路径 | String | 是 |
响应
响应码
重命名或移动成功,返回 HTTP 204 No Content(ConflictResolutionStrategy 为 ask)或 HTTP 200 OK(ConflictResolutionStrategy 为 rename)。
响应体
空,无响应体(ConflictResolutionStrategy 为 ask)或 application/json(ConflictResolutionStrategy 为 rename)。
响应体示例:
{ "path": [ "foo", "bar_new (1)" ] }
响应体字段说明:
响应参数 | 描述 | 类型 |
path | 表示最终的目录或相簿路径,因为可能存在自动重命名,所以这里的最终路径可能不等同于移动/重命名目录或相簿时指定的路径 | Array |