创建目录
功能介绍
创建目录
接口约束
如果文件系统协议类型为SMB协议，创建的目录会初始化权限为everyone完全控制权限，则指定的属主用户ID、属主用户组ID、目录权限不生效。
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 |
错误响应 |
错误码
请参见错误码。
