新增文件目录 - createDirectory
功能介绍
新增文件目录。
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/directory
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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。如果传入了该请求头,则说明当前的操作是在共享文件夹内。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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 | 参数解释: 自定义属性 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
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 | 创建目录完成返回的信息 |

