クロスリージョンバックアップファイルに含まれるデータベースとテーブルの照会 -

ApsaraDB RDS for MySQLインスタンスは、クロスリージョンバックアップと復元をサポートしています。詳細については、「リージョン間のApsaraDB RDS For MySQLインスタンスのバックアップ」および「リージョン間のApsaraDB RDS for MySQLインスタンスのデータの復元」をご参照ください。

この操作を呼び出す前に、インスタンスが次のデータベースエンジンのいずれかを実行していることを確認してください。

MySQL。詳細については、「ApsaraDB RDS For MySQLインスタンスのリージョン間のバックアップ」をご参照ください。
SQL Server。詳細については、「ApsaraDB RDS For SQL Serverインスタンスのリージョン間のバックアップ」をご参照ください。
配布キーを修正します。詳細については、「ApsaraDB RDS For PostgreSQLインスタンスのリージョン間のバックアップ」をご参照ください。

デバッグ

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

リクエストパラメーター


項目	データ型	必須／任意	例:	説明
操作	String	必須	DescribeCrossBackupMetaList	実行する操作です。値をDescribeCrossBackupMetaListに設定します。
BackupSetId	String	必須	123456	使用するクロスリージョンバックアップファイルのID。 DescribeCrossRegionBackupsを呼び出して、クロスリージョンバックアップファイルのIDを照会できます。
GetDbName	String	任意	testdb1	クエリするデータベースの名前。システムは、このパラメーターの値に基づいて完全一致を実装し、一致したデータベースの名前と一致したデータベース内のテーブルの名前を返します。
Pattern	String	任意	test	クエリするデータベースの名前。システムは、このパラメーターの値に基づいてファジー一致を実装し、一致したデータベースの名前のみを返します。説明ファジーマッチと完全一致を実装できます。たとえば、Patternパラメーターをtestに設定して、testdb1およびtestdb2データベースを照会できます。次に、GetDbNameパラメーターを指定して、一致したデータベースと一致したデータベース内のテーブルのみをクエリできます。
PageSize	String	任意	30	各ページで返されるエントリ数。既定値：1 説明このパラメーターは、PageIndexパラメーターを指定した場合にのみ有効です。
PageIndex	String	いいえ	1	返されるページ数。有効値：0 以外の正の整数。説明このパラメーターは、PageSizeパラメーターを指定した場合にのみ有効です。
リージョン	String	任意	cn-hangzhou	インスタンスのリージョン ID です。
ResourceGroupId	String	任意	rg-acfmy *****	リソースグループの ID です。

レスポンスパラメーター


項目	データ型	例:	説明
DBInstanceName	String	rm-uf6wjk5xxxxxxx	クロスリージョンバックアップファイルが属するインスタンス。
TotalPageCount	Integer	1	返されたページの総数。
RequestId	String	60F9A12A-16B8-4728-B099-4CA38D32C31C	リクエストの ID です。
PageRecordCount	Integer	1	現在のページで返されたエントリの数。
TotalRecordCount	Integer	1	返されたエントリの総数。
PageNumber	Integer	1	返されたページ数。
項目	メタの配列		クロスリージョンバックアップファイルにデータが含まれているデータベースとテーブルに関する情報で構成される配列。
メタ未満です。
表	String	test1,test2	データベースに含まれるテーブルの名前で構成される配列。データベースに複数のテーブルが含まれている場合、これらのテーブルの名前はコンマ (,) で区切られます。
データベース	String	testdb1	データベースの名前。
サイズ	String	1000	テーブルのサイズ。 (単位：KB) データベースに複数のテーブルが含まれている場合、これらのテーブルの名前はコンマ (,) で区切られます。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=DescribeCrossBackupMetaList
&BackupSetId=123456
&GetDbName=testdb1
&PageSize=30
&PageIndex=1
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

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

<DescribeCrossBackupMetaListResponse>
<TotalRecordCount>1</TotalRecordCount>
<TotalPageCount>1</TotalPageCount>
<RequestId>60F9A12A-16B8-4728-B099-4CA38D32C31C</RequestId>
<PageNumber>1</PageNumber>
<アイテム>
    <メタ>
        <サイズ> 4320</サイズ>
        <サイズ> 5</サイズ>
        <データベース> testdb1</Database>
        <テーブル> test1</テーブル>
        <テーブル> test2</テーブル>
    </メタ>
</アイテム>
<DBInstanceName>rm-uf6wjk5xxxxxxx</DBInstanceName>
</DescribeCrossBackupMetaListResponse>

JSON 形式

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

{
  "TotalRecordCount" : 1、
  "TotalPageCount" : 1、
  "RequestId" : "60F9A12A-16B8-4728-B099-4CA38D32C31C" 、
  "PageNumber" : 1,
  "アイテム" : {
    "メタ" : [ {
      "サイズ" : [ 4320、5] 、
      "データベース" : "testdb1" 、
      "テーブル" : [ "test1", "test2"]
    } ]
  },
  "DBInstanceName" : "rm-uf6wjk5xxxxxxx"
}

エラーコード


HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidPageSize	ページサイズが無効です	PageSizeパラメーターの値が無効な場合に返されるエラーメッセージ。 PageSizeパラメーターに有効な値を指定する必要があります。
400	InvalidRestoreTime. フォーマット	指定された復元時間は無効です。	RestoreTimeパラメーターの値が無効な場合に返されるエラーメッセージ。 RestoreTimeパラメーターに有効な値を指定する必要があります。
403	InvalidMeta.Empty	メタ情報は空です。	Metaパラメーターの値が空の場合に返されるエラーメッセージ。
403	IncorrectDBInstanceType	現在のDBインスタンスタイプは、この操作をサポートしていません。	インスタンスが現在の状態の場合、この操作がサポートされていない場合に返されるエラーメッセージ。
403	IncorrectEngineVersion	現在のエンジンバージョンは操作をサポートしていません。	インスタンスで実行されているデータベースエンジンバージョンでは、この操作がサポートされていない場合に返されるエラーメッセージ。
403	InvalidBackupLogStatus	現在のバックアップログ有効ステータスは、この操作をサポートしていません。	ログバックアップ機能が無効になっているため、特定の時点までデータを復元できない場合に返されるエラーメッセージ。
404	InvalidBackupSetID.NotFound	指定されたバックアップセットIDが存在しません。	指定されたデータバックアップファイルが存在しない場合に返されるエラーメッセージ。有効なデータバックアップファイルを指定する必要があります。
404	Request.NotFound	要求されたリソースは使用できません。	リクエストしたリソースが利用できない場合に返されるエラーメッセージ。

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