本文导读

展开导读

文档首页/ 云空间服务 KooDrive/ API参考/ API/ 文件管理/ 新增文件目录

新增文件目录

更新时间：2025-03-14 GMT+08:00

查看PDF

功能介绍

新增文件目录。

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表示美式英语，不传默认美式英语

表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	智能文件夹属性（该功能目前只有白名单用户使用）

表3 SmartFolderAttr
参数	是否必选	参数类型	描述
name	否	Integer	属性名称
type	否	Integer	属性类型
value	否	String	属性值
sort	否	Integer	排序值

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
id	String	文件id
fileName	String	文件名
mimeType	String	文件格式
code	String	响应码
msg	String	响应信息

请求示例

在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	创建目录完成返回的信息

父主题： 文件管理

上一篇：获取文件详情

下一篇：创建文件元数据

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问