新增文件目录 - 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 | 创建目录完成返回的信息 |