新增文件目录 - createDirectory
功能介绍
新增文件目录。
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/directory
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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表示美式英语，不传默认美式英语 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
重名策略，枚举值：
|
|
hidden |
否 |
Boolean |
目录是否隐藏（该功能目前只有白名单用户使用） |
|
smartFolderAttr |
否 |
Array of SmartFolderAttr objects |
智能文件夹属性（该功能目前只有白名单用户使用） |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
文件id |
|
fileName |
String |
文件名 |
|
mimeType |
String |
文件格式 |
|
code |
String |
响应码 |
|
msg |
String |
响应信息 |
|
existFileId |
String |
已存在的文件id，当请求的renameMode指定为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 |
创建目录完成返回的信息 |
