# 创建目录 - CreateFsDir
#### 功能介绍
创建目录。
#### 接口约束
如果文件系统协议类型为SMB协议，创建的目录会初始化权限为everyone完全控制权限，则指定的属主用户ID、属主用户组ID、目录权限不生效。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/SFSTurbo/doc?api=CreateFsDir)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfsturbo/sfsturbo_02_0079.html)。
#### URI
POST /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/dir
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述     |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID   |
| share_id   | 是    | String | 文件系统ID |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述       |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 账号的token |
| Content-Type | 是    | String | MIME类型   |
   
表3请求Body参数 
| 参数   | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| path | 是    | String | 合法的目录全路径                                                                                                                                                                                                                               |
| mode | 否    | Long   | 目录权限，默认值是755，取值范围是0到777。第一位表示目录所有者的权限，取值范围是0到7；第二位表示目录所属用户组的权限，取值范围是0到7；第三位表示其他用户的权限，取值范围是0到7。目录所有者由uid指定，目录所属用户组由gid指定，不是目录所有者且不在目录所属用户组的用户为其他用户。例如：755中第一位7代表该目录所有者对该目录具有读、写、执行权限；第二位5代表该目录所属用户组对该目录具有读、执行权限；第三位5代表其他用户对该目录具有读、执行权限。 |
| uid  | 否    | Long   | 目录所有者的用户id，默认值是0，取值范围是0到4,294,967,294（即2\^32-2）。                                                                                                                                                                                       |
| gid  | 否    | Long   | 目录所属用户组id，默认值是0，取值范围是0到4,294,967,294（即2\^32-2）。                                                                                                                                                                                        |
   
#### 响应参数
**状态码：204**
创建目录成功
**状态码：400**
表4响应Body参数 
| 参数      | 参数类型   | 描述   |
|:---|:---|:---|
| errCode | String | 错误码  |
| errMsg  | String | 错误描述 |
   
**状态码：409**
表5响应Body参数 
| 参数      | 参数类型   | 描述   |
|:---|:---|:---|
| errCode | String | 错误码  |
| errMsg  | String | 错误描述 |
   
**状态码：500**
表6响应Body参数 
| 参数      | 参数类型   | 描述   |
|:---|:---|:---|
| errCode | String | 错误码  |
| errMsg  | String | 错误描述 |
   
#### 请求示例
创建一个目录，目录的全路径是"/date/test"。
```
{
  "path" : "/date/test"
}
```
#### 响应示例
**状态码：400**
错误响应
```
{
  "errCode" : "SFS.TURBO.0122",
  "errMsg" : "invalid mode"
}
```
**状态码：409**
错误响应，目录冲突
```
{
  "errCode" : "SFS.TURBO.0114",
  "errMsg" : "path already exist"
}
```
**状态码：500**
错误响应
```
{
  "errCode" : "SFS.TURBO.0005",
  "errMsg" : "Internal server error"
}
```
#### 状态码
| 状态码 | 描述        |
|:---|:---|
| 204 | 创建目录成功    |
| 400 | 错误响应      |
| 409 | 错误响应，目录冲突 |
| 500 | 错误响应      |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-sfsturbo/ErrorCode.html)。