文档首页/ 云空间服务 KooDrive/ API参考/ API/ 文件管理/ 新增文件目录 - createDirectory
更新时间：2026-02-03 GMT+08:00
查看PDF
分享

新增文件目录 - createDirectory

功能介绍

新增文件目录。

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/directory

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token}

X-User-Id

是

String

用户id，用于app鉴权

X-Date

是

String

日期，用于app鉴权

Host

是

String

地址，用于app鉴权

X-Traceid

否

String

消息日志跟踪标识（必须58位）

language

否

String

国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语

x-hw-share-folder-id

否

String

参数解释：

共享文件夹ID。如果传入了该请求头，则说明当前的操作是在共享文件夹内。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表2 请求Body参数

参数

是否必选

参数类型

描述

createdTime

否

String

文件创建时间。

格式：yyyy-MM-ddTHH:mm:ss.sssZ

description

否

String

文件描述。字符长度不超过512字符，不能包括emoji等非法字符。

mimeType

否

String

资源类型

editedTime

否

String

文件修改时间

fileName

是

String

文件名。不能包括'<>|:"*?/'，不能等于'..','.','',最长250字符

fileType

是

String

文件类型，外部输入。

固定为10。

parentFolder

否

Array of strings

父目录标识列表，只取第一个作为父目录。

为空时默认建到root目录下

containerId

是

String

空间标识ID

renameMode

否

Integer

重名策略，枚举值：

  • 2：强制重命名，出现重名文件时，文件名末尾追加时间戳

  • 3：拒绝重命名，出现重名文件时，创建失败

hidden

否

Boolean

目录是否隐藏（该功能目前只有白名单用户使用）

smartFolderAttr

否

Array of SmartFolderAttr objects

智能文件夹属性（该功能目前只有白名单用户使用）

scene

否

String

自定义属性
表3 SmartFolderAttr

参数

是否必选

参数类型

描述

name

否

Integer

属性名称

type

否

Integer

属性类型

value

否

String

属性值

sort

否

Integer

排序值

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

id

String

文件id

fileName

String

文件名

mimeType

String

文件格式

code

String

响应码

msg

String

响应信息

existFileId

String

已存在的文件id，当请求的重名策略指定为3时，出现同名文件时返回

请求示例

在IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4空间下的根目录创建文件夹。

POST /koodrive/ose/v1/directory

Authorization:Bearer+10f88*********4791e9ff

{
    "createdTime": "",
    "editedTime": "",
    "description": "222",
    "mimeType": "application/vnd.huawei-apps.folder",
    "fileName": "ttgg",
    "fileType": "10",
    "parentFolder": [
        "root"
    ],
    "containerId": "IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4",
    "renameMode": "2"
}

响应示例

状态码：200

创建目录完成返回的信息

{
  "id" : "FqAHbpps7uJEDpvh2MbpLj7lD4AM2OWMR",
  "fileName" : "ttgg",
  "mimeType" : "application/vnd.huawei-apps.folder",
  "code" : 0,
  "msg" : "success"
}

状态码

状态码

描述

200

创建目录完成返回的信息
父主题： 文件管理