创建目录
功能介绍
创建目录
URI
POST /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/dir
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID |
| share_id | 是 | String | 文件系统ID |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 账号的token |
| Content-Type | 是 | String | MIME类型 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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
| 参数 | 参数类型 | 描述 |
|---|---|---|
| errCode | String | 错误码 |
| errMsg | String | 错误描述 |
状态码：409
| 参数 | 参数类型 | 描述 |
|---|---|---|
| errCode | String | 错误码 |
| errMsg | String | 错误描述 |
状态码：500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 错误响应 |
错误码
请参见错误码。
