# 查询目标文件夹配额 - ShowFsDirQuota
#### 功能介绍
查询目标文件夹配额。查询的used_capacity、used_inode数据可能有延迟。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/SFSTurbo/doc?api=ShowFsDirQuota)中调试该接口，支持自动认证鉴权。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-quota
表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  | 合法的已存在的目录的全路径                                                                                                    |
| capacity      | Integer | 目录的容量大小，单位：MB                                                                                                    |
| inode         | Integer | 目录的inode数量限制                                                                                                     |
| used_capacity | Integer | 目录已使用的容量大小，单位：MB。仅SFS Turbo 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB返回该字段。数据可能有延迟。 |
| used_inode    | Integer | 目录的已使用的inode数量。仅SFS Turbo 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB返回该字段。数据可能有延迟。   |
   
**状态码：400**
表5响应Body参数 
| 参数      | 参数类型   | 描述   |
|:---|:---|:---|
| errCode | String | 错误码  |
| errMsg  | String | 错误描述 |
   
**状态码：500**
表6响应Body参数 
| 参数      | 参数类型   | 描述   |
|:---|:---|:---|
| errCode | String | 错误码  |
| errMsg  | String | 错误描述 |
   
#### 请求示例
文件系统ID为"77ba6f4b-6365-4895-8dda-bc7142af4dd0"，目录的全路径是"/data/test"，查询该目录的quota值
```
GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4dd0/fs/dir-quota?path=/data/test
```
#### 响应示例
**状态码：200**
查询目录的配额信息成功
```
{
  "path" : "/data/test",
  "capacity" : 1024,
  "inode" : 100000
}
```
**状态码：400**
错误响应
```
{
  "errCode" : "SFS.TURBO.0102",
  "errMsg" : "Path is not directory"
}
```
**状态码：500**
错误响应
```
{
  "errCode" : "SFS.TURBO.0005",
  "errMsg" : "Internal server error"
}
```
#### 状态码
| 状态码 | 描述          |
|:---|:---|
| 200 | 查询目录的配额信息成功 |
| 400 | 错误响应        |
| 500 | 错误响应        |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-sfsturbo/ErrorCode.html)。