创建目录
功能介绍
创建目录
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。第一位表示目录所有者的权限，第二位表示目录所属用户组的权限，第三位表示其他用户的权限。目录所有者由uid指定，目录所属用户组由gid指定，不是目录所有者且不在目录所属用户组的用户为其他用户。例如：755中第一位7代表该目录所有者对该目录具有读、写、执行权限；第二位5代表该目录所属用户组对该目录具有读、执行权限；第三位5代表其他用户对该目录具有读、执行权限。 最小值：0 |
uid |
否 |
Long |
目录所有者的用户id，默认值是0，取值范围是0到4,294,967,294（即2^32-2）。 最小值：0 |
gid |
否 |
Long |
目录所属用户组id，默认值是0，取值范围是0到4,294,967,294（即2^32-2）。 最小值：0 |
响应参数
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
errCode |
String |
错误码 最小长度：8 最大长度：36 |
errMsg |
String |
错误描述 最小长度：2 最大长度：512 |
状态码： 409
参数 |
参数类型 |
描述 |
|---|---|---|
errCode |
String |
错误码 最小长度：8 最大长度：36 |
errMsg |
String |
错误描述 最小长度：2 最大长度：512 |
状态码： 500
参数 |
参数类型 |
描述 |
|---|---|---|
errCode |
String |
错误码 最小长度：8 最大长度：36 |
errMsg |
String |
错误描述 最小长度：2 最大长度：512 |
请求示例
创建一个目录，目录的全路径是“/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 |
错误响应 |
错误码
请参见错误码。
