# 新增文件目录 - createDirectory
#### 功能介绍
新增文件目录。
#### 授权信息
当前API调用无需身份策略权限。
#### 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鉴权                                                                                                                                                                                                                                                                                                                   |
| X-Traceid            | 否    | String | 消息日志跟踪标识（必须58位）                                                                                                                                                                                                                                                                                                              |
| language             | 否    | String | 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语                                                                                                                                                                                                                                                                           |
| 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 | 智能文件夹属性（该功能目前只有白名单用户使用）                                                                                                                                                                                                                                                                                                                                                                        |
| scene           | 否    | String                                                                        | 自定义属性                                                                                                                                                                                                                                                                                                                                                                                          |
   
 表3SmartFolderAttr 
| 参数    | 是否必选 | 参数类型    | 描述   |
|:---|:---|:---|:---|
| 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，当请求的重名策略指定为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 | 创建目录完成返回的信息 |