更新时间:2024-11-12 GMT+08:00
分享

查询目标文件夹quota

功能介绍

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

调试

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

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。仅SFSTurbo 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB返回该字段。数据可能有延迟。

used_inode

Integer

目录的已使用的inode数量。仅SFSTurbo 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

错误响应

错误码

请参见错误码

相关文档