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

调试

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

请求参数

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

系统规定参数，取值：DescribeResourceUsage。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

实例ID。

返回数据

名称 类型 示例值 描述
DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。
Engine String MySQL

数据库类型。
DiskUsed Long 2337275904

已用空间（DataSize+LogSize），单位：Byte。-1表示没有数据。
DataSize Long 1292094741

数据文件占用空间，单位：Byte。-1表示没有数据。
LogSize Long 1045181163

日志占用空间，单位：Byte。-1表示没有数据。
BackupSize Long 53002759

备份占用空间，单位：Byte。-1表示没有数据。
ColdBackupSize Long 2337275904

冷备份的占用空间，单位：Byte。-1表示没有数据。
SQLSize Long 315052751

SQL的占用空间，单位：Byte。-1表示没有数据。
ArchiveBackupSize Long 0

归档备份的占用空间，单位：Byte。
BackupDataSize Long 94324736

数据备份的占用空间（不包括归档备份），单位：Byte。
BackupLogSize Long 45145563

日志备份的占用空间（不包括归档备份），单位：Byte。
BackupOssDataSize Long 8821760

OSS中备份集的数据文件大小，单位：Byte。0表示没有数据。
BackupOssLogSize Long 44180999

OSS中备份集的日志文件大小，单位：Byte。0表示没有数据。
PaidBackupSize Long 0

扣除免费额度后，需要付费的备份占用空间，单位：Byte。
RequestId String F937E173-559C-4498-8D90-38D32342B9E4

请求ID。

示例

请求示例

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

正常返回示例

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 格式 

{
	"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"
}

错误码

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