文档首页/ 高性能弹性文件服务 SFS Turbo/ API参考/ API/ 目录管理/ 查询目标文件夹配额 - ShowFsDirQuota
更新时间：2025-11-14 GMT+08:00
查看PDF
分享

查询目标文件夹配额 - ShowFsDirQuota

功能介绍

查询目标文件夹配额。查询的used_capacity、used_inode数据可能有延迟。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

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

表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

合法的已存在的目录的全路径

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-bc7142af4ddw"，目录的全路径是“/data/test”，查询该目录的quota值

GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4ddw/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

错误响应

错误码

请参见错误码。

父主题： 目录管理