文档首页/ 云数据库 GaussDB/ API参考/ API(推荐)/ 磁盘管理/ 查询实例存储空间使用信息
更新时间:2024-08-20 GMT+08:00

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

功能介绍

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

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.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in14/volume-usage

响应示例

查询实例空间信息成功。

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

状态码

错误码

请参见错误码