DescribeDetachedBackups操作を呼び出して、削除されたインスタンスのデータバックアップファイルを照会できます。

この操作は、ローカルSSDでMySQLを実行するインスタンスでサポートされています。 インスタンスのリリース後にインスタンスのデータバックアップファイルを保持する方法の詳細については、「自動バックアップの設定」をご参照ください。

デバッグ

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

リクエストパラメーター

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

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

DBInstanceId String 任意 rm-uf6wjk5xxxxxxx

インスタンスの ID です。

BackupId String 任意 327xxxxx3

データバックアップファイルのID。

BackupStatus String 任意 成功

データバックアップファイルのステータス。 有効な値：

  • 成功
  • 失敗しました
BackupMode String 任意 Automated

データバックアップファイルのバックアップモード。 有効な値：

  • 自動化
  • マニュアル
StartTime String 任意 2021-03-01T16:00Z

クエリする期間の開始時刻です。

yyyy-MM-dd T HH:mm Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。

EndTime String 任意 2021-03-15T16:00Z

クエリする期間の終了時刻を設定します。 終了時刻は開始時刻よりも後の時刻にする必要があります。

時間はyyyy-MM-dd T HH:mm Z形式のISO 8601標準に従います。 時刻は UTC で表示されます。

PageSize Integer いいえ 30

各ページで返されるエントリ数。 有効な値：

  • 30
  • 50
  • 100
説明 既定値： 30.
PageNumber Integer いいえ 1

返されるページ数。 有効値：0 以外の正の整数。

説明 デフォルト値：1
リージョン String 必須 cn-hangzhou

インスタンスのリージョン ID です。

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

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

レスポンスパラメーター

項目 データ型 例: 説明　
PageNumber String 1

返されたページ数。

RequestId String 1A6D328C-84B8-40DC-BF49-6C73984D7494

リクエストの ID です。

PageRecordCount String 30

ページ上のデータバックアップファイルの数。

TotalRecordCount String 100

返されたエントリの総数。

項目 バックアップの配列

返されたデータバックアップファイルの詳細。

バックアップ
ConsistentTime Long 1576506856

データバックアップファイル内のデータが一貫している時点。 このパラメーターの戻り値はタイムスタンプです。

説明 インスタンスがMySQL 5.6を実行する場合、タイムスタンプが返されます。 そうでなければ、値0が返される。
StoreStatus String 無効

データバックアップファイルを削除できるかどうかを示します。 有効な値：

  • 有効: データバックアップファイルを削除できます。
  • 無効: データバックアップファイルは削除できません。
BackupStatus String 成功

データバックアップファイルのステータス。 有効な値：

  • 成功
  • 失敗しました
BackupType String FullBackup

バックアップの種類。 有効な値：

  • FullBackup
  • IncrementalBackup
BackupStartTime String 2019-02-03T12:20:00Z

バックアップの開始時間。

時間はyyyy-MM-dd T HH:mm Z形式のISO 8601標準に従います。 時刻は UTC で表示されます。

BackupDownloadURL String http://rdsbak-hz-v3.oss-cn-hangzhou.aliyuncs.com/xxxxx

インターネット経由でデータバックアップファイルをダウンロードするために使用されるURL。 データバックアップファイルをダウンロードできない場合は、空の文字列が返されます。

IsAvail Integer 1

データバックアップファイルが使用可能かどうかを示します。 有効な値：

  • 0: データバックアップファイルは使用できません。
  • 1: データバックアップファイルが利用可能です。
メタステータス String OK

個々のデータベースまたはテーブルの復元に使用されるデータバックアップファイルのステータス。 有効な値：

  • OK: データバックアップファイルは正常です。
  • LARGE: データバックアップファイルに異常に多数のテーブルが含まれています。 個々のデータベースやテーブルの復元には使用できません。
  • 空: データバックアップファイルは、失敗したバックアップタスクから生成されます。
BackupEndTime String 2019-02-13T12:20:00Z

バックアップの終了時刻。

時間はyyyy-MM-dd T HH:mm Z形式のISO 8601標準に従います。 時刻は UTC で表示されます。

BackupId String 321020562

データバックアップファイルのID。

HostInstanceID String 5882781

いいえ。 データバックアップファイルを生成するインスタンスの このパラメーターは、データバックアップファイルを生成するインスタンスがプライマリインスタンスであるかセカンダリインスタンスであるかを示すために使用されます。

BackupIntranetDownloadURL String http://rdsbak-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/xxxxx

内部ネットワーク経由でデータバックアップファイルをダウンロードするために使用されるURL。 データバックアップファイルをダウンロードできない場合は、空の文字列が返されます。

BackupSize Long 2167808

データバックアップファイルのサイズ。 単位：バイト

BackupMode String Automated

データバックアップファイルのバックアップモード。 有効な値：

  • 自動化
  • マニュアル
DBInstanceId String rm-uf6wjk5xxxxxxx

インスタンスの ID です。

DBInstanceComment String test

インスタンスの説明。

BackupMethod String Physical

データバックアップファイルの生成に使用されるメソッド。 有効な値：

  • 論理: 論理バックアップ
  • Physical: 物理バックアップ

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=DescribeDetachedBackups
&リージョン=cn-hangzhou
&<共通リクエストパラメーター>

通常のレスポンス例

XML 形式

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

<DescribeDetachedBackupsResponse>
  <TotalRecordCount>1</TotalRecordCount>
  <PageRecordCount>1</PageRecordCount>
  <RequestId>B0BBC25A-6B3E-4BFD-A052-48664294E20D</RequestId>
  <ページ番号> 1 </ PAGENUMBER>
  <Items>
        <Backup>
              <BackupMethod>Snapshot</BackupMethod>
              <BackupInitiator> システム </BackupInitiator>
              <StorageClass>0</StorageClass>
              <BackupMode>Automated</BackupMode>
              <BackupSize>161061273600</BackupSize>
              <BackupId>677987116</BackupId>
              <IsAvail>1</IsAvail>
              <HostInstanceID>9232003</HostInstanceID>
              <BackupDBNames></BackupDBNames>
              <StoreStatus> 無効 </StoreStatus>
              <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
              <BackupDownloadURL></BackupDownloadURL>
              <BackupEndTime>2020-07-11T05:07:33Z</BackupEndTime>
              <BackupStartTime>2020-07-11T05:07:33Z</BackupStartTime>
              <ConsistentTime>0</ConsistentTime>
              <BackupType>FullBackup</BackupType>
              <MetaStatus></MetaStatus>
              <BackupScale>DBInstance</BackupScale>
              <BackupStatus>Success</BackupStatus>
              <BackupLocation>OSS</BackupLocation>
        </Backup>
  </Items>
  <TotalBackupSize>161061273600</TotalBackupSize>
</DescribeDetachedBackupsResponse>

JSON 形式

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

{
  "TotalRecordCount" : 1、
  "PageRecordCount" : 1、
  "RequestId" : "B0BBC25A-6B3E-4BFD-A052-48664294E20D" 、
  "PageNumber" : 1,
  "アイテム" : {
    "バックアップ" : [ {
      "BackupMethod" : "Physical" 、
      "BackupIntranetDownloadURL" : "http://..." 、
      "BackupMode" : "Automated" 、
      "BackuppSize" : 9405440、
      "BackupId" : 509538643、
      "IsAvail" : 1、
      "HostInstanceID" : 100453678、
      "BackupDBNames" : "" 、
      "StoreStatus" : "Enabled" 、
      "DBInstanceId" : "rm-uf6wjk5xxxxxxx" 、
      "BackupDownloadURL" : "https://..." 、
      "BackupEndTime" : "2020-09-04T02:55:36Z" 、
      "BackupStartTime" : "2020-09-04T02:54:04Z" 、
      "ConsistentTime" : "1599188049" 、
      "BackupType" : "FullBackup" 、
      "MetaStatus" : "OK" 、
      "BackupScale" : "DBInstance" 、
      "BackupStatus" : "Success" 、
      "BackupLocation" : "OSS"
    } ]
  },
  "TotalBackupSize" : "161061273600"
}

エラーコード

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