调用DescribeResourceUsage查看存储预留模式实例的存储空间使用情况。
使用说明
本接口一般用于查看存储预留模式实例的存储空间使用情况,包括数据文件占用空间、日志占用空间以及备份占用空间。
QPS限制
本接口的单用户QPS限制默认为1000次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。
本文档中的QPS仅为默认参考值,准确信息请参见API速率配额列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeResourceUsage |
系统规定参数。取值:DescribeResourceUsage。 |
DBInstanceId | String | 是 | gp-rj*************** |
存储预留模式实例ID。 说明 您可以调用DescribeDBInstances接口查看目标地域下所有的AnalyticDB PostgreSQL实例的详情,包括实例ID。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
LogSize | Long | 201326592 |
日志占用空间,单位:Byte。-1表示没有数据。 |
RequestId | String | 47AB1806-37FF-5E92-A91E-F2********** |
请求ID。 |
DBInstanceId | String | gp-rj*************** |
实例ID。 |
DataSize | Long | 405798912 |
数据文件占用空间,单位:Byte,-1表示没有数据。 |
BackupSize | Long | 26624 |
备份占用空间,单位:Byte。-1表示没有数据。 |
DiskUsed | Long | 607125504 |
已用空间,由数据文件占用空间和日志占用空间组成,单位:Byte。-1表示没有数据。 |
Engine | String | gpdb |
数据库类型。 |
示例
请求示例
https://gpdb.aliyuncs.com/?Action=DescribeResourceUsage
&DBInstanceId=gp-rj***************
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeResourceUsageResponse>
<LogSize>201326592</LogSize>
<RequestId>47AB1806-37FF-5E92-A91E-F2**********</RequestId>
<DBInstanceId>gp-rj***************</DBInstanceId>
<DataSize>405798912</DataSize>
<BackupSize>26624</BackupSize>
<DiskUsed>607125504</DiskUsed>
<Engine>gpdb</Engine>
</DescribeResourceUsageResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"LogSize" : 201326592,
"RequestId" : "47AB1806-37FF-5E92-A91E-F2**********",
"DBInstanceId" : "gp-rj***************",
"DataSize" : 405798912,
"BackupSize" : 26624,
"DiskUsed" : 607125504,
"Engine" : "gpdb"
}
错误码
访问错误中心查看更多错误码。