查询数据库占用空间大小列表 - QueryingDatabaseStorageUsage
调试
您可以在API Explorer中调试该接口。
URI
GET /v3.1/{project_id}/instances/{instance_id}/database-volume
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 |
|
instance_id |
是 |
String |
参数解释: 实例ID,此参数是用户创建实例的唯一标识。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为36个字符。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
database_name |
否 |
String |
参数解释: 数据库名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
table_space_name |
否 |
String |
参数解释: 数据库的缺省表空间名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
user_name |
否 |
String |
参数解释: 表所属用户名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
offset |
否 |
Integer |
参数解释: 索引位置,偏移量。从第一条数据偏移offset条数据后开始查询。 约束限制: 不涉及。 取值范围: 0 - 10000 默认取值: 0 |
|
limit |
否 |
Integer |
参数解释: 查询记录数。 约束限制: 不能为负数。 取值范围: 最小值为1,最大值为200。 默认取值: 100 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
X-Language |
否 |
String |
参数解释: 语言。 约束限制: 不涉及。 取值范围:
默认取值: en-us |
响应参数
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
database_volumes |
Array of objects |
参数解释: 数据库占用空间列表。详情请参见表5。 |
|
total_count |
Integer |
参数解释: 总数。 取值范围: 不涉及。 |
请求示例
查询数据库占用空间大小列表。
GET https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3.1/3d39c18788b54a919bab633874c159dfin14/instances/3d39c18788b54a919bab633874c159dfin01/database-volume
响应示例
{
"database_volumes": [
{
"database_name": "postgres",
"table_space_name": "pg_default",
"user_name": "rdsAdmin",
"database_size": "708 MB"
}
],
"total_count": 1
}
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。