# 查询目录是否存在 - ShowFsDir
#### 功能介绍
查询目录是否存在。
#### 约束限制
该接口不适用于100MB/s/TiB-智算型、200MB/s/TiB-智算型文件系统。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/SFSTurbo/doc?api=ShowFsDir)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfsturbo/sfsturbo_02_0079.html)。
#### URI
GET /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/dir
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述     |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID   |
| share_id   | 是    | String | 文件系统ID |
   
表2Query参数 
| 参数   | 是否必选 | 参数类型   | 描述          |
|:---|:---|:---|:---|
| 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 | 错误响应       |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-sfsturbo/ErrorCode.html)。