查询目录是否存在 - ShowFsDir

project_id

是

String

参数解释：

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

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

share_id

是

String

参数解释：

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

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

path

是

String

参数解释：

需要查询的目录全路径。

约束限制：

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

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

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

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

• 如果目录不存在，接口返回404错误。

取值范围：

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

默认取值：

不涉及。

X-Auth-Token

是

String

参数解释：

用户Token，用于鉴权认证。

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

Content-Type

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

application/json

默认取值：

application/json

path

String

参数解释：

目录的全路径。

取值范围：

不涉及。

mode

Long

参数解释：

目录权限，使用八进制数字表示。

• 前两位表示文件类型，固定为40，表示目录类型。

• 第三位表示目录所有者的权限，第四位表示目录所属用户组的权限，第五位表示其他用户的权限。目录所有者由uid指定，目录所属用户组由gid指定，不是目录所有者且不在目录所属用户组的用户为其他用户。其中4表示读权限，2表示写权限，1表示执行权限。

• 例如：40755中前两位40表示目录类型；第三位7代表目录所有者对该目录具有读、写、执行权限；第四位5代表该目录所属用户组对该目录具有读、执行权限；第五位5代表其他用户对该目录具有读、执行权限。

• 仅20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB、HPC缓存型文件系统返回该字段。

取值范围：

40000到40777的整数。

uid

Long

参数解释：

目录所有者的用户ID。仅20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB、HPC缓存型文件系统返回该字段。

取值范围：

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

gid

Long

参数解释：

目录所属用户组的ID。仅20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB、HPC缓存型文件系统返回该字段。

取值范围：

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

errCode

String

参数解释：

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

取值范围：

不涉及。

errMsg

String

参数解释：

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

取值范围：

不涉及。

errCode

String

参数解释：

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

取值范围：

不涉及。

errMsg

String

参数解释：

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

取值范围：

不涉及。

errCode

String

参数解释：

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

取值范围：

不涉及。

errMsg

String

参数解释：

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

取值范围：

不涉及。

200

查询目录结果

400

错误响应

404

错误响应，目录不存在

500

错误响应