调用DescribeResourceUsage接口查询RDS实例的空间使用信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeResourceUsage

系统规定参数。取值:DescribeResourceUsage

DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。

ResourceGroupId String rg-acfmy*****

资源组ID。

返回数据

名称 类型 示例值 描述
BackupOssDataSize Long 8821760

OSS中备份集的数据文件大小,单位:Byte。0表示没有数据。

DiskUsed Long 2337275904

已用空间(DataSize+LogSize),单位:Byte。-1表示没有数据。

ArchiveBackupSize Long 0

归档备份的占用空间,单位:Byte。

BackupOssLogSize Long 44180999

OSS中备份集的日志文件大小,单位:Byte。0表示没有数据。

BackupLogSize Long 45145563

日志备份的占用空间(不包括归档备份),单位:Byte。

BackupDataSize Long 94324736

数据备份的占用空间(不包括归档备份),单位:Byte。

ColdBackupSize Long 2337275904

冷备份的占用空间,单位:Byte。-1表示没有数据。

DataSize Long 1292094741

数据文件占用空间,单位:Byte。-1表示没有数据。

PaidBackupSize Long 0

扣除免费额度后,需要付费的备份占用空间,单位:Byte。

RequestId String F937E173-559C-4498-8D90-38D32342B9E4

请求ID。

LogSize Long 1045181163

日志占用空间,单位:Byte。-1表示没有数据。

BackupSize Long 53002759

备份占用空间,单位:Byte。-1表示没有数据。

DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。

Engine String MySQL

数据库类型。

SQLSize Long 315052751

SQL的占用空间,单位:Byte。-1表示没有数据。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeResourceUsage
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeResourceUsageResponse>
<PaidBackupSize>0</PaidBackupSize>
<RequestId>28E73580-103C-4925-A48D-9A7E25F24297</RequestId>
<BackupSize>51305057407</BackupSize>
<ArchiveBackupSize>0</ArchiveBackupSize>
<ColdBackupSize>-1</ColdBackupSize>
<LogSize>2097152</LogSize>
<BackupOssLogSize>48565375</BackupOssLogSize>
<DBInstanceId> rm-uf6wjk5xxxxxxx</DBInstanceId>
<BackupDataSize>51256492032</BackupDataSize>
<DataSize>3198156800</DataSize>
<BackupLogSize>48565375</BackupLogSize>
<BackupOssDataSize>0</BackupOssDataSize>
<SQLSize>446228522</SQLSize>
<DiskUsed>3200253952</DiskUsed>
<Engine>MySQL</Engine>
</DescribeResourceUsageResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PaidBackupSize" : 0,
  "RequestId" : "28E73580-103C-4925-A48D-9A7E25F24297",
  "BackupSize" : 51305057407,
  "ArchiveBackupSize" : 0,
  "ColdBackupSize" : -1,
  "LogSize" : 2097152,
  "BackupOssLogSize" : "48565375",
  "DBInstanceId" : " rm-uf6wjk5xxxxxxx",
  "BackupDataSize" : 51256492032,
  "DataSize" : 3198156800,
  "BackupLogSize" : 48565375,
  "BackupOssDataSize" : "0",
  "SQLSize" : 446228522,
  "DiskUsed" : 3200253952,
  "Engine" : "MySQL"
}

错误码

访问错误中心查看更多错误码。