CheckCreateDdrDBInstance操作を呼び出して、クロスリージョンバックアップセットを使用してソースインスタンスのデータをターゲットインスタンスに復元できるかどうかを確認できます。

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

デバッグ

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

リクエストパラメーター

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

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

RegionId String 必須 cn-hangzhou

ターゲットインスタンスのリージョンID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

Engine String 必須 MySQL

ターゲットインスタンスのデータベースエンジン。 有効な値：

  • MySQL
  • SQLServer
  • PostgreSQL
EngineVersion String 必須 5.6

ターゲットインスタンスのメジャーエンジンバージョン。 このパラメーターの値は、Engineパラメーターの値によって異なります。

  • EngineパラメーターをMySQLに設定したときの有効な値: 5.5、5.6、5.7、および8.0
  • Valid値を設定するときEngineパラメータにSQLServer: 2008r2、08r2_ent_ha、2012、2012_ent_ha、2012_std_ha、2012_web、2014_std_ha、2016_ent_ha、2016_std_ha、2016_web、2017_std_ha、2017_ent、2019_std_ha、と2019_ent
  • EngineパラメーターをPostgreSQLに設定したときの有効な値: 10.0、11.0、12.0、13.0、14.0、および15.0
DBInstanceClass String 必須 rds.mysql.s1.small

ターゲットインスタンスのインスタンスタイプ。 詳細については、「プライマリApsaraDB RDSインスタンスタイプ」をご参照ください。

DBInstanceStorage Integer 〇 20

ターゲットインスタンスのストレージ容量。 有効な値: 5 ~ 2000 単位 : GB

この値は5GBの倍数である必要があります。詳しくはPrimary ApsaraDB RDS instance types.

RestoreType String 必須 0

使用する復元方法。 有効な値：

  • 0: バックアップセットからデータを復元します。 このパラメーターを0に設定した場合、BackupSetIdパラメーターも指定する必要があります。
  • 1: データをある時点に復元します。 このパラメーターを1に設定した場合、RestoreTime、SourceRegion、およびSourceDBInstanceNameパラメーターも指定する必要があります。

デフォルト値：0。

BackupSetId String 任意 14358

復元に使用されるバックアップセットのID。 DescribeCrossRegionBackupsを呼び出して、バックアップセットのIDを照会できます。

説明 RestoreTypeパラメーターを 0に設定した場合は、このパラメーターも指定する必要があります。
RestoreTime String 任意 2019-05-30T03:29:10Z

データを復元する時点。 指定する時点は、現在の時刻より前である必要があります。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。

説明 RestoreTypeパラメーターを 1に設定した場合は、このパラメーターも指定する必要があります。
SourceRegion String 任意 cn-hangzhou

データをある時点に復元する場合のソースインスタンスのリージョンID。

説明 RestoreTypeパラメーターを 1に設定した場合は、このパラメーターも指定する必要があります。
SourceDBInstanceName String 任意 rm-uf6wjk5xxxxxxx

データをある時点に復元する場合のソースインスタンスのID。

説明 RestoreTypeパラメーターを 1に設定した場合は、このパラメーターも指定する必要があります。

レスポンスパラメーター

項目 データ型 例: 説明
IsValid String 真実

ソースインスタンスのデータをリージョン間で復元できるかどうかを示します。 有効な値: trueとfalse。
RequestId String 1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC

リクエストの ID です。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=CheckCreateDdrDBInstance
&RegionId=cn-hangzhou
&エンジン=MySQL
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=20
&EngineVersion=5.6
&RestoreType=0
&BackupSetId=14358
&<共通リクエストパラメーター>

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

XML 形式

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

<CheckCreateDdrDBInstanceResponse>
  <IsValid>true</IsValid>
  <RequestId>346C62D7-8BB9-4516-93E7-25A469EAABCB</RequestId>
</CheckCreateDdrDBInstanceResponse>

JSON 形式

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

{
  "IsValid" : "true" 、
  "RequestId" : "346C62D7-8BB9-4516-93E7-25A469EAABCB"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 IncorrectDBInstanceType 現在のDBインスタンスエンジンとタイプは操作をサポートしていません。 この操作がデータベースエンジンとインスタンスのインスタンスタイプでサポートされていない場合に返されるエラーメッセージ。
400 InvalidRestoreType. フォーマット 指定された復元タイプは無効です。 指定された復元タイプが無効な場合に返されるエラーメッセージ。 有効な復元タイプを指定します。
400 NoBackupSetRegion BackupSetRegionは不在です。 バックアップ領域が存在しない場合に返されるエラーメッセージ。
400 IncorrectBackupSetType バックアップセットタイプはddrです。 バックアップセットのタイプがDDRでない場合に返されるエラーメッセージ。
400 NoSourceInstanceName SourceDBInstanceNameはありません。 ソースインスタンスの名前が見つからない場合に返されるエラーメッセージ。
400 NoAvailableDisasterRestoreBakset 利用可能な災害復元baksetがありません。 使用可能なバックアップセットが見つからない場合に返されるエラーメッセージ。
400 IncorrectBackupSetMethod 現在のバックアップセットメソッドは操作をサポートしていません。 指定されたバックアップセットを使用して個々のデータベースとテーブルを復元できない場合に返されるエラーメッセージ。
400 InvalidBackupType.Format Specified backup type is not valid. 指定されたバックアップタイプが無効な場合に返されるエラーメッセージ。
400 IncorrectEngineVersion 現在のエンジンバージョンは操作をサポートしていません。 インスタンスで実行されているデータベースエンジンバージョンでは、この操作がサポートされていない場合に返されるエラーメッセージ。
400 IncorrectBaksetVersion 現在のbaksetバージョンは操作をサポートしていません。 バックアップセットのバージョンで操作がサポートされていない場合に返されるエラーメッセージ。
400 CrossRegionUnsupportTDE クロスリージョンディザスタリストアはTDE baksetをサポートしていません。 TDEベースのバックアップセットを使用してインスタンスを別のリージョンに復元できない場合に返されるエラーメッセージ。
400 DisasterRestoreRegionNotMatched ディザスタリストアは、ddrリージョンまたはソースリージョンで操作する必要があります。 ディザスタリカバリをソースインスタンスまたはターゲットインスタンスのリージョンで実行する必要がある場合に返されるエラーメッセージ。
400 InvalidMinorVersion.NotFound 指定されたマイナーバージョンが存在しません。 指定されたマイナーエンジンバージョンが存在しない場合に返されるエラーメッセージ。
400 InvalidDBInstanceId.MalFormed 指定されたパラメータ DBInstanceId は無効です。 インスタンスIDが無効な場合に返されるエラーメッセージ。 インスタンスIDを確認します。
400 InvalidEngine.Malformed 指定されたエンジンは無効です。 データベースエンジンが無効な場合に返されるエラーメッセージ。 有効なデータベースエンジンを指定します。
400 InvalidEngineVersion.Malformed 指定されたエンジンバージョンが無効です。 指定されたデータベースエンジンのバージョンが無効な場合に返されるエラーメッセージ。 データベースエンジンのバージョンを確認して、もう一度お試しください。
400 MissingUserID リクエストにuser_idパラメーターがありません。 指定されたユーザーIDが存在しない場合に返されるエラーメッセージ。
400 MissingUID リクエストにuidパラメーターがありません。 使用するアカウントが存在しない場合に返されるエラーメッセージ。
400 UserPermissionFailure ユーザー権限によりリクエスト処理に失敗しました。 必要な権限がない場合に返されるエラーメッセージ。
400 InvalidServiceType. フォーマット 指定されたサービスタイプは無効です。 サービスタイプが無効な場合に返されるエラーメッセージ。 サービスタイプを0または1に設定します。 値0はAlibaba Cloudサービスを示し、値1はJSTサービスを示します。
400 InvalidStorage. フォーマット 指定されたストレージは無効です。 Storageパラメーターの値が無効な場合に返されるエラーメッセージ。 パラメーターに有効な値を指定します。
403 IncorrectDBType 現在のDBタイプはこの操作をサポートしていません。 この操作がインスタンスのデータベースエンジンでサポートされていない場合に返されるエラーメッセージ。 別のデータベースエンジンを指定します。
403 IncorrectDBInstance 現在のDBインスタンスはこの操作をサポートしていません。 操作がインスタンスでサポートされていない場合に返されるエラーメッセージ。
403 ResourceConfigError リソース設定エラーにより、リクエスト処理が失敗しました。 リソース設定エラーが発生した場合に返されるエラーメッセージ。
404 RestoreType.NotFound RestoreTypeが見つかりません。 指定された復元方法が存在しない場合に返されるエラーメッセージ。
404 InvalidBackupSetID.NotFound 指定されたバックアップセットIDが存在しません。 指定されたバックアップセットが存在しない場合に返されるエラーメッセージ。 有効なバックアップセットを指定します。
404 InvalidDBInstance.NotFound 指定されたインスタンスが存在しないか、サポートされていません。 指定されたインスタンスが見つからない場合に返されるエラーメッセージ。 インスタンスのIDを確認します。
404 InvalidDBInstanceClass.NotFound 指定された DB インスタンスクラスが見つかりません。 新しいインスタンスタイプが見つからないか、購入できなくなった場合に返されるエラーメッセージ。 使用可能なインスタンスタイプを選択します。

エラーコードの一覧については、「サービスエラーコード」をご参照ください。