智能媒资托管创建目录或相簿

功能描述 
本接口用于在指定的媒体库或空间内创建新的 目录或相簿，当 媒体库 类型为媒体类型时可使用。
您可通过创建目录或相簿对文件进行分类整理、结构化上传与管理，操作清晰简便，尤其适合个人相册、作品集、活动影像等场景的快速搭建与管理。
说明：
需要 admin、space_admin 或 create_directory 权限。有关权限详情请参见 生成访问令牌接口。
媒体类型媒体库可以进一步设置是否为分相簿媒体库。当设置为不分相簿时，则不允许创建目录或相簿，当设置为分相簿时，仅允许创建1层目录或相簿；文件类型媒体库不限制目录层数。
自动创建中间所需的各级父目录。
即使 ConflictResolutionStrategy 为 rename，如果路径中的某一父级实际为文件，则依然会返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码。
请求示例
PUT /api/v1/directory/`{LibraryId}`/`{SpaceId}`/`{DirPath}`?conflict_resolution_strategy=`{ConflictResolutionStrategy}`&access_token=`{AccessToken}`&user_id=`{UserId}&with_inode={WithInode}`
请求参数
请求参数
描述
类型
是否必选
LibraryId
媒体库 ID，在媒体托管控制台创建媒体库后获取，请参见 创建媒体库﻿
String
是
SpaceId
空间 ID，如果媒体库为单租户模式，则该参数固定为连字符(-)；如果媒体库为多租户模式，则为具体 ID，获取请参见 创建租户空间﻿
String
是
DirPath
目录路径或相簿名。
对于多级目录，使用斜杠(`/`)分隔，例如 `foo/bar`。
对于根目录，该参数留空。
String
否
ConflictResolutionStrategy
最后一级目录冲突时的处理方式：
ask: 冲突时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码
rename：冲突时自动重命名最后一级目录
默认为 ask
String
否
AccessToken
访问令牌，获取请参见 生成访问令牌﻿
String
是
UserId
用户身份识别，当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份，详情请参见 生成访问令牌接口﻿
String
否
WithInode
0 或 1，是否返回 inode，即文件目录 ID，默认不返回
String
否
请求体
该请求无请求体。
响应
响应码
创建成功，返回 HTTP 201 Created。
响应体
空，无响应体（ConflictResolutionStrategy 为 ask 且 WithInode为0）或 application/json（ConflictResolutionStrategy 为 rename 或 WithInode为1）。
响应体示例：
ConflictResolutionStrategy 为 ask 且 WithInode为1：
{
    "creationTime": "2025-09-29T02:53:09.000z"
    "inode": "b63393076d249110000631c316d9751a"}
}
ConflictResolutionStrategy 为 rename 且 WithInode为0：
{ 
    "creationTime": "2025-09-29T02:53:09.000z"
    "path": [ "foo", "bar (1)" ]
}
ConflictResolutionStrategy 为 rename 且 WithInode为1：
{ 
    "creationTime": "2025-09-29T02:53:09.000z"
    "path": [ "foo", "bar (1)" ],
    "inode": "b63393076d249110000631c316d9751a"
}
响应体字段说明：
响应参数
描述
类型
creationTime
创建时间
String
path
表示最终的目录或相簿路径，因为可能存在自动重命名，所以这里的最终路径可能不等同于创建目录或相簿时指定的路径
String
inode
最后一级文件目录 ID
String
错误码
该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。

请求参数	描述	类型	是否必选
LibraryId	媒体库 ID，在媒体托管控制台创建媒体库后获取，请参见创建媒体库	String	是
SpaceId	空间 ID，如果媒体库为单租户模式，则该参数固定为连字符(`-`)；如果媒体库为多租户模式，则为具体 ID，获取请参见创建租户空间	String	是
DirPath	目录路径或相簿名。对于多级目录，使用斜杠(`/`)分隔，例如 `foo/bar`。对于根目录，该参数留空。	String	否
ConflictResolutionStrategy	最后一级目录冲突时的处理方式： ask: 冲突时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码 rename：冲突时自动重命名最后一级目录默认为 ask	String	否
AccessToken	访问令牌，获取请参见生成访问令牌	String	是
UserId	用户身份识别，当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份，详情请参见生成访问令牌接口	String	否
WithInode	0 或 1，是否返回 inode，即文件目录 ID，默认不返回	String	否

响应参数	描述	类型
creationTime	创建时间	String
path	表示最终的目录或相簿路径，因为可能存在自动重命名，所以这里的最终路径可能不等同于创建目录或相簿时指定的路径	String
inode	最后一级文件目录 ID	String

创建目录或相簿

本页目录：

功能描述

请求示例

请求参数

请求体

响应

响应码

响应体

错误码