文档首页/ 云备份 CBR/ API参考/ API/ 存储库/ 存储库容量总览 - ShowSummary
更新时间:2025-11-03 GMT+08:00

存储库容量总览 - ShowSummary

功能介绍

查询项目下所有存储库的总容量和总使用量

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v3/{project_id}/vaults/summary

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,默认取值不涉及。

获取方法请参见"获取项目ID"。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

size

Integer

总容量大小,单位GB,取值范围大于零。

used_size

Integer

总使用容量,单位GB,取值范围大于零。

请求示例

GET https://{endpoint}/v3/{{project_id}}/vaults/summary

响应示例

状态码:200

OK

{
  "size" : 27670,
  "used_size" : 43
}

状态码

状态码

描述

200

OK

错误码

请参见错误码