更新时间:2026-02-03 GMT+08:00

新增文件目录 - createDirectory

功能介绍

新增文件目录。

授权信息

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

URI

POST /koodrive/ose/v1/directory

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

language

String

参数解释:

国际化语言标识

约束限制:

符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语

取值范围:

不涉及

默认取值:

不传默认美式英语

Authorization

String

参数解释:

该字段存储的是Access Token。

调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。

约束限制:

格式参考:Bearer+{access_token}

取值范围:

Access Token的获取请参考对应的开发手册

默认取值:

不涉及

X-Traceid

String

参数解释:

消息日志跟踪标识(必须58位)

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-User-Id

String

参数解释:

koodrive侧用户id,用于app鉴权

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Date

String

参数解释:

日期,用于app鉴权

约束限制:

距当前时间15分钟以内,不能晚于当前时间

取值范围:

日期格式,yyyMMdd'T'HHmmss'Z',例:20251103T070140Z

默认取值:

不涉及

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

参数解释:

智能文件夹属性

约束限制:

该功能目前只有白名单用户使用

取值范围:

最大100

默认取值:

不涉及

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

请求示例

在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

创建目录完成返回的信息