创建目录 - CreateFsDir

project_id

是

String

参数解释：

项目ID，用于标识资源所属的IAM项目空间，实现项目级资源隔离与权限管控。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

share_id

是

String

参数解释：

文件系统ID，用于唯一标识SFS Turbo文件系统实例。

获取方法请参见查询文件系统列表接口。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Auth-Token

是

String

参数解释：

用户Token，用于鉴权认证。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

Content-Type

是

String

参数解释：

请求消息体MIME类型，用于标识请求正文的数据格式。

约束限制：

不涉及。

取值范围：

application/json

默认取值：

application/json

path

是

String

参数解释：

需要创建的目录全路径。

约束限制：

• 必须以斜杠“/”开头，表示绝对路径。

• 不能包含“/./”或“/../”等特殊路径符号。

• 单层目录名称长度不能超过255个字符。

• 全路径总长度不能超过4096个字符。

• 目录不能已存在，否则接口返回409错误。

取值范围：

文件系统内的合法目录全路径字符串，例如“/data/test”。

默认取值：

不涉及。

mode

否

Long

参数解释：

目录权限，使用八进制数字表示。第一位表示目录所有者的权限，取值范围是0到7；第二位表示目录所属用户组的权限，取值范围是0到7；第三位表示其他用户的权限，取值范围是0到7。其中4表示读权限，2表示写权限，1表示执行权限。

例如：755中第一位7代表该目录所有者对该目录具有读、写、执行权限；第二位5代表该目录所属用户组对该目录具有读、执行权限；第三位5代表其他用户对该目录具有读、执行权限。

约束限制：

不涉及。

取值范围：

000到777的整数。

默认取值：

755

uid

否

Long

参数解释：

目录所有者的用户ID。

约束限制：

不涉及。

取值范围：

0到4294967294（即2^32-2）的整数。

默认取值：

0

gid

否

Long

参数解释：

目录所属用户组的ID。

约束限制：

不涉及。

取值范围：

0到4294967294（即2^32-2）的整数。

默认取值：

0

errCode

String

参数解释：

错误码，用于标识请求失败的原因。详细错误码请参见错误码。

取值范围：

不涉及。

errMsg

String

参数解释：

错误描述，用于描述请求失败的具体原因，便于排查问题。请参见错误码。

取值范围：

不涉及。

errCode

String

参数解释：

错误码，用于标识请求失败的原因。详细错误码请参见错误码。

取值范围：

不涉及。

errMsg

String

参数解释：

错误描述，用于描述请求失败的具体原因，便于排查问题。请参见错误码。

取值范围：

不涉及。

errCode

String

参数解释：

错误码，用于标识请求失败的原因。详细错误码请参见错误码。

取值范围：

不涉及。

errMsg

String

参数解释：

错误描述，用于描述请求失败的具体原因，便于排查问题。请参见错误码。

取值范围：

不涉及。

204

创建目录成功

400

错误响应

409

错误响应，目录冲突

500

错误响应