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