调用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"
}
错误码
访问错误中心查看更多错误码。