产品简介

产品概述

功能介绍

产品优势

应用场景

基本概念

购买指南

快速入门

创建媒体库

发起请求

服务级 API 文档

History

Introduction

API Category

Making API Requests

PaaS Service APIs

Official Cloud Disk APIs

Data Types

Error Codes

业务级 API 文档

简介

访问令牌操作接口

租户空间操作接口

文件操作接口

目录或相簿操作接口

回收站操作接口

配额操作接口

查询任务操作接口

搜索操作接口

历史版本操作接口

目录和文件批量操作接口

收藏操作接口

Error Codes

SDK 文档

Android SDK

iOS SDK

鸿蒙 SDK

常见问题

企业网盘

产品简介

购买指南

快速入门

常见问题

Service Level Agreement

词汇表

创建目录或相簿

PDF

聚焦模式

字号

最后更新时间： 2026-01-07 14:52:06

功能描述 
用于创建目录或相簿。
说明：
需要 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
错误码
该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

智能媒资托管

创建目录或相簿

功能描述

请求示例

请求参数

请求体

响应

响应码

响应体

错误码

帮助和支持

请求参数	描述	类型	是否必选
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