文档首页/ 弹性文件服务 SFS/ API参考/ SFS Turbo API说明/ 目录管理/ 查询目录是否存在
更新时间：2025-05-09 GMT+08:00
查看PDF
分享

查询目录是否存在

功能介绍

查询目录是否存在

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/dir

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

share_id

是

String

文件系统ID
表2 Query参数

参数

是否必选

参数类型

描述

path

是

String

需要查询的目录的全路径

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

path

String

目录全路径

mode

Long

目录权限，仅20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB、HPC缓存型文件系统返回该字段。第三位表示目录所有者的权限，第四位表示目录所属用户组的权限，第五位表示其他用户的权限。目录所有者由uid指定，目录所属用户组由gid指定，不是目录所有者且不在目录所属用户组的用户为其他用户。例如：40755中第三位7代表目录所有者对该目录具有读、写、执行权限；第四位5代表目录所属用户组对该目录具有读、执行权限；第五位5代表其他用户对该目录具有读、执行权限。

uid

Long

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

gid

Long

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

状态码：400

表5 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码：404

表6 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码：500

表7 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

请求示例

文件系统ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde"，目录的全路径是“/date/test”，查询该目录是否存在

GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/{share_id}/fs/dir?path=/date/test

响应示例

状态码：200

查询目录结果

{
  "path" : "/date/test"
}

状态码：400

错误响应

{
  "errCode" : "SFS.TURBO.0100",
  "errMsg" : "invalid path"
}

状态码：404

错误响应，目录不存在

{
  "errCode" : "SFS.TURBO.0101",
  "errMsg" : "path not exist"
}

状态码：500

错误响应

{
  "errCode" : "SFS.TURBO.0005",
  "errMsg" : "Internal server error"
}

状态码

状态码

描述

200

查询目录结果

400

错误响应

404

错误响应，目录不存在

500

错误响应

错误码

请参见错误码。

父主题： 目录管理

相关文档