GaussDB查询实例存储空间使用信息

查询实例存储空间使用信息

功能介绍

查询指定实例的存储使用空间和最大空间。

• 调用接口前，您需要了解API 认证鉴权。
• 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

调试

您可以在API Explorer中调试该接口。

URI

GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/volume-usage

表1 参数说明

名称	是否必选	说明
project_id	是	参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。
instance_id	是	实例ID。

请求参数

无。

响应参数

表2 参数说明

参数	参数类型	描述
used	String	已使用量。表示当前实例已使用的存储空间大小（单位：GB）。
total	String	总量。表示当前实例最大存储空间大小（单位：GB）。

请求示例

查询实例存储空间使用信息。

GET https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in14/volume-usage

响应示例

查询实例空间信息成功。

{
  "used" : "15.0", 
  "total" : "185.0"
}

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。

父主题： 磁盘管理