DescribeResourceUsage操作を呼び出して、ApsaraDB RDSインスタンスのストレージ使用状況を照会できます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorerは、さまざまなSDKのサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 DescribeResourceUsage

実行する操作です。 値をDescribeResourceUsageに設定します。

DBInstanceId String 必須 rm-uf6wjk5xxxxxxx

インスタンスの ID です。

ResourceGroupId String 任意 rg-acfmy *****

リソースグループの ID です。

レスポンスパラメーター

項目 データ型 例: 説明　
BackupOssDataSize Long 8821760

Object Storage Service (OSS) バケットに保存されているデータバックアップファイルのサイズ。 単位：バイト 値0は、OSSバケットにデータバックアップファイルが保存されていないことを示します。

DiskUsed Long 2337275904

インスタンス上のデータファイルとログファイルによって占有される総ストレージ。 単位：バイト 値-1は、インスタンスにデータファイルまたはログファイルが保存されていないことを示します。

ArchiveBackuppSize Long 0

インスタンス上のアーカイブバックアップファイルによって占有されているストレージ。 単位：バイト

BackupOssLogSize Long 44180999

OSSバケットに保存されているログバックアップファイルのサイズ。 単位：バイト 値0は、ログバックアップファイルがOSSバケットに保存されていないことを示します。

BackupLogSize Long 45145563

インスタンス上のログバックアップファイル (アーカイブバックアップファイルを除く) が占有するストレージ。 単位：バイト

BackupDataSize Long 94324736

インスタンス上のデータバックアップファイル (アーカイブバックアップファイルを除く) が占有するストレージ。 単位：バイト

ColdBackuppSize Long 2337275904

コールドバックアップファイルの保存に使用されるストレージ。 単位：バイト 値-1は、コールドバックアップファイルが保存されていないことを示します。

DataSize Long 1292094741

データファイルの格納に使用されるストレージ。 単位：バイト 値-1は、データファイルが格納されていないことを示します。

PaidBackuppSize Long 0

支払う必要があるバックアップストレージ。 ApsaraDB RDSは、バックアップストレージに無料のクォータを提供します。 無料クォータを超えるバックアップストレージの料金を支払う必要があります。 単位：バイト

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

リクエストの ID です。

LogSize Long 1045181163

ログファイルの格納に使用されるストレージ。 単位：バイト 値-1は、ログファイルが格納されていないことを示します。

BackupSize Long 53002759

バックアップファイルの格納に使用されるストレージ。 単位：バイト 値-1は、バックアップファイルが格納されていないことを示します。

DBInstanceId String rm-uf6wjk5xxxxxxx

インスタンスの ID です。

Engine String MySQL

インスタンスが実行されるデータベースエンジン。

SQLSize Long 315052751

インスタンスでSQL文を実行するために占有されるストレージ。 単位：バイト 値-1は、SQL文が実行されないことを示します。

例

リクエストの例

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>
<ArchiveBackuppSize> 0</ArchiveBackuppSize>
<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>
<エンジン> MySQL</Engine>
</DescribeResourceUsageResponse>

JSON 形式 

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

{
  "PaidBackupSize" : 0、
  "RequestId" : "28E73580-103C-4925-A48D-9A7E25F24297" 、
  "BackuppSize" : 51305057407、
  "ArchiveBackuppSize" : 0、
  "ColdBackupSize" : -1、
  "LogSize" : 2097152、
  "BackupOssLogSize" : "48565375" 、
  "DBInstanceId" : "rm-uf6wjk5xxxxxxx" 、
  "BackupDataSize" : 51256492032、
  "DataSize" : 3198156800、
  "BackupLogSize" : 48565375、
  "BackupOssDataSize" : "0" 、
  "SQLSize" : 446228522、
  "DiskUsed" : 3200253952、
  "エンジン" : "MySQL"
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。