CreateDdrInstance操作を呼び出して、インスタンスのデータを別のリージョンにある新しいインスタンスに復元できます。

この操作を呼び出す前に、CheckCreateDdrDBInstance操作を呼び出して、ソースインスタンスのデータをクロスリージョンバックアップファイルから復元できるかどうかを確認できます。

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

デバッグ

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

リクエストパラメーター

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

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

RegionIdString必須cn-hangzhou

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

EngineString必須MySQL

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

  • MySQL
  • SQLServer
  • PostgreSQL
EngineVersionString必須5.6

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

  • EngineパラメーターをMySQLに設定したときの有効な値: 5.5、5.6、5.7、および8.0
  • エンジンパラメーターをSQL Serverに設定するときの有効な値: 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に設定したときの有効な値: 9.4、10.0、11.0、12.0、および13.0
DBInstanceClassString必須rds.mysql.s1.small

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

DBInstanceStorageInteger20

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

この値は5 GBの倍数である必要があります。 詳細については、「プライマリApsaraDB RDSインスタンスタイプ」をご参照ください。

SystemDBCharsetString任意uft8

ターゲットインスタンスの文字セット。 有効な値:

  • utf8
  • gbk
  • latin1
  • utf8mb4
DBInstanceNetTypeString必須イントラネット

宛先インスタンスのネットワーク接続タイプ。 有効な値:

  • インターネット: インターネット
  • イントラネット: 内部ネットワーク
DBInstanceDescriptionString任意testdatabase

ターゲットインスタンスの名前。 名前は2 ~ 256文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は英字とする必要があります。

説明 名前は http:// または https:// で始めることはできません。
SecurityIPListString必須127.0.0.1

ターゲットインスタンスのIPアドレスホワイトリスト。 IPアドレスホワイトリストに複数のエントリを追加する場合は、エントリをコンマ (,) で区切ります。 各エントリは一意である必要があります。 最大1,000個のエントリを追加できます。 詳細については、「ApsaraDB RDS For MySQLインスタンスのIPアドレスホワイトリストの設定」をご参照ください。 IPアドレスホワイトリストのエントリは、次のいずれかの形式である必要があります。

  • IPアドレス。 例: 10.23.12.24。
  • CIDRブロック。 例: 10.23.12.24/24。 この例では、24は、CIDRブロックのプレフィックスが24ビット長であることを示します。 24を1から32の範囲の値に置き換えることができます。
ClientTokenString任意ETnLKlblzczshOTUbOCzxxxxxxxxxx

リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、生成されたトークンが異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。

PayTypeString必須プリペイド

ターゲットインスタンスの課金方法。 有効な値:

  • 後払い: 従量課金
  • プリペイド: サブスクリプション
ZoneIdString任意cn-hangzhou-d

ターゲットインスタンスのゾーンID。 ターゲットインスタンスが複数のゾーンにデプロイされている場合は、ゾーンのIDをコロン (:) で区切ります。

説明 仮想プライベートクラウド (VPC) とvSwitchを指定する場合は、ZoneIdパラメーターも指定する必要があります。
InstanceNetworkTypeString任意Classic

ターゲットインスタンスのネットワークタイプ。 有効な値:

  • [VPC]
  • クラシック

デフォルト値: Classic。

説明 このパラメーターをVPCに設定した場合、VPCIdおよびVSwitchIdパラメーターも指定する必要があります。
ConnectionModeString任意スタンダード

接続先インスタンスの接続モード。 有効な値:

  • 標準: 標準モード
  • セーフ: データベースプロキシモード

デフォルト値: Standard

VPCIdString任意vpc-xxxxxxxxxxxx

ターゲットインスタンスのVPC ID。 このパラメーターは、InstanceNetworkTypeパラメーターをVPCに設定した場合にのみ使用できます。

説明 このパラメーターを指定する場合は、ZoneIdパラメーターも指定する必要があります。
VSwitchIdString任意vsw-xxxxxxxxxxx

ターゲットインスタンスのvSwitch ID。 複数のvSwitchを指定する場合は、vSwitchのIDをカンマ(,)で区切ってください。このパラメータは、 InstanceNetworkType パラメータを VPCに設定した場合のみ利用可能です。.

説明 このパラメーターを指定する場合は、ZoneIdパラメーターも指定する必要があります。
PrivateIpAddressString任意172.XXX.XXX.69

ターゲットインスタンスのプライベートIPアドレス。 プライベートIPアドレスは、指定されたvSwitchでサポートされているCIDRブロック内にある必要があります。 システムは、 VPCIdVSwitchId パラメータの値に基づいて、インスタンスに自動的にプライベートIPアドレスを割り当てます。

UsedTimeString×2

インスタンスのサブスクリプション期間。 有効な値:

  • PeriodパラメーターをYearに設定した場合、UsedTimeパラメーターの値は1から3の範囲です。
  • [期間] パラメーターを [月] に設定した場合、UsedTimeパラメーターの値は1〜9の範囲です。
説明 PayTypeパラメーターを前払いに設定した場合、このパラメーターも指定する必要があります。
期間String任意

ターゲットインスタンスのサブスクリプション期間を測定するために使用される単位。 有効な値:

説明 PayTypeパラメーターを前払いに設定した場合、このパラメーターも指定する必要があります。
ResourceGroupIdString任意rg-acfmyxxxxxxxxxx

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

RestoreTypeString必須BackupSet

データの復元に使用されるメソッド。 有効な値:

  • BackupSet: データがバックアップセットから復元されます。 この値を使用する場合は、BackupSetIDパラメーターも指定する必要があります。
  • BackupTime: データをある時点に復元します。 RestoreTimeSourceRegion、およびSourceDBInstanceNameパラメーターも指定する必要があります。
BackupSetIdString任意14 ***

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

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

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

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

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

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

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

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

ターゲットインスタンスのストレージタイプ。 ローカルSSDストレージタイプのみがサポートされています。 デフォルト値: local_ssd

レスポンスパラメーター

項目データ型例:説明
DBInstanceIdStringrm-xxxxx

ターゲットインスタンスの ID。

RequestIdStringE52666CC-330E-418A-8E5B-A19E3FB42D13

リクエストの ID です。

ポートString3306

宛先インスタンスへの接続に使用されるポート番号。

説明 DBInstanceNetTypeパラメーターは、ポートが内部ポートかパブリックポートかを示します。
ConnectionStringStringrm-xxxxx.mysql.rds.aliyuncs.com

ターゲットインスタンスへの接続に使用されるエンドポイント。

説明 DBInstanceNetTypeパラメーターは、エンドポイントが内部エンドポイントかパブリックエンドポイントかを示します。
OrderIdString2038691xxxxx

注文 ID。

リクエストの例

http(s):// rds.aliyuncs.com/?Action=CreateDdrInstance
&RegionId=cn-hangzhou
&エンジン=MySQL
&EngineVersion=5.6
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=20
&SystemDBCharset=uft8
&DBInstanceNetType=イントラネット
&DBInstanceDescription=testdatabase
&SecurityIPList=127.0.0.1
&ClientToken=ETnLKlblzczshOTUbOCzxxxxxxxxxx
&PayType=前払い
&ZoneId=cn-hangzhou-b
&InstanceNetworkType=クラシック
&ConnectionMode=標準
&VPCId=vpc-xxxxxxxxxxxx
&VSwitchId=vsw-xxxxxxxxxxx
&PrivateIpAddress=172.XXX. XXX.69
&UsedTime=2
&期間=年
&ResourceGroupId=rg-acfmyxxxxxxxxxx
&RestoreType=BackupSet
&BackupSetId=14 ***
&RestoreTime=2019-05-30T03:29:10Z
&SourceRegion=cn-hangzhou
&SourceDBInstanceName=rm-uf6wjk5xxxxxxx
&DBInstanceStorageType=local_ssd
&共通リクエストパラメータ

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

XML 形式

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

<CreateDdrInstanceResponse>
    <RequestId>E52666CC-330E-418A-8E5B-A19E3FB42D13</RequestId>
    <DBInstanceId>rm-xxxxx</DBInstanceId>
    <Port>3306</Port>
    <ConnectionStrin g>rm-xxxxx.mysql.rds.aliyuncs.com</ConnectionString>
    <OrderId>2038691xxxxx</OrderId>
</CreateDdrInstanceResponse>

JSON 形式

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

{
  "RequestId" : "E52666CC-330E-418A-8E5B-A19E3FB42D13" 、
  "DBInstanceId" : "rm-xxxxx" 、
  "ポート" : "3306" 、
  "ConnectionString" : "rm-xxxxx.mysql.rds.aliyuncs.com" 、
  "OrderId" : "2038691xxxxx"
}

エラーコード

HTTP ステータスコードエラーコードエラーメッセージ説明
400InvalidZoneId.NotSupported指定されたvpcゾーンはサポートされていません。指定されたゾーンでVPCにインスタンスを作成できない場合に返されるエラーメッセージ。 別のゾーンを指定して、もう一度お試しください。
400InvalidDBInstanceName. フォーマット指定された DB インスタンス名は無効です。インスタンスが存在しない場合に返されるエラーメッセージ。 インスタンス情報を確認します。
400InvalidDBInstanceName.Duplicate指定された DB インスタンス名は、既に RDS に存在します。インスタンス名が既に存在する場合に返されるエラーメッセージ。 別の名前を指定して、もう一度お試しください。
400InvalidRegion. フォーマット指定されたリージョンは無効です。指定されたリージョンが無効な場合に返されるエラーメッセージ。
400InvalidServiceType. フォーマット指定されたサービスタイプは無効です。サービスタイプが無効な場合に返されるエラーメッセージ: サービスタイプを0または1に設定します。 値0はAlibaba Cloudサービスを示し、値1はJSTサービスを示します。
400InvalidEngine.Malformed指定されたエンジンは無効です。データベースエンジンが無効な場合に返されるエラーメッセージ。 有効なデータベースエンジンを指定します。
400InvalidEngineVersion.Malformed指定されたエンジンバージョンが無効です。指定されたデータベースエンジンのバージョンが無効な場合に返されるエラーメッセージ。 データベースエンジンのバージョンを確認して、もう一度お試しください。
400InvalidConnectionString. フォーマット指定された接続文字列は無効です。エンドポイントのプレフィックスが無効な場合に返されるエラーメッセージ。 プレフィックスの長さは5 ~ 40文字である必要があります。
400InvalidConnectionString.Duplicate指定された接続文字列は既にAliyun RDS に存在します。指定したエンドポイントが既に存在する場合に返されるエラーメッセージ。 別のエンドポイントを指定します。
400InvalidCharacterSetName. フォーマット指定された文字セット名は無効です。指定された文字セットが無効な場合に返されるエラーメッセージ。 ApsaraDB RDSは、GBK、UTF-8、EUC-KR、およびASCIIの文字セットをサポートしています。
400InvalidDBInstanceType. フォーマット指定されたインスタンスタイプは無効です。指定されたインスタンスタイプが無効な場合に表示されるエラーメッセージ。 インスタンスタイプを選択し直してください。
400InvalidPort.Malformed指定されたポートが有効でない。指定したポート番号が無効な場合に返されるエラーメッセージ。
400InvalidBackupRetentionPeriod.Malformed指定されたバックアップ保存期間が有効ではありません。指定されたバックアップサイクルが無効な場合に返されるエラーメッセージ。 バックアップサイクルは、1日を超えるか、30日以下である必要があります。
400InvalidPreferredBackupTime.Format指定された優先バックアップ時刻が無効です。バックアップ時刻の形式が正しくない場合に返されるエラーメッセージ。 時間をYYYY-MM-DDThh:mmZ形式でGMTで指定します。 例: 2012-06-11T15:00Z。
400InvalidPreferredBackupPeriod.Malformed指定されたバックアップ期間は無効です。バックアップ時刻が無効な場合に返されるエラーメッセージ。
400InvalidExpiredTime. フォーマット指定された有効期限は無効です。ExpiredTimeパラメーターの値が無効な場合に返されるエラーメッセージ。 the yyyy-MM-ddTHH:mm:ssZ 形式で時刻を指定します。 時間は UTC にする必要があります。
400InvalidSecurityIPList.Format指定されたセキュリティIPリストの形式が無効です。IPアドレスホワイトリストが無効な場合に返されるエラーメッセージ。 IPアドレスホワイトリストを確認します。
400InvalidSecurityIPList.Duplicate指定されたセキュリティIPリストが無効: リスト内の重複IPアドレス指定されたIPアドレスまたはCIDRブロックが無効な場合に返されるエラーメッセージ。 指定されたIPアドレスまたはCIDRブロックが重複しています。
400InvalidSecurityIPList.QuotaExceeded指定されたセキュリティIPリストは無効です: リスト内のIPアドレスの許容量を超えています。指定されたIPアドレスホワイトリストのエントリ数が上限を超えた場合に返されるエラーメッセージ。 IPアドレスホワイトリストには、最大1,000個のエントリを指定できます。
400InvalidDBInstanceDescription.Format指定された DB インスタンスの説明は無効です。DBInstanceDescriptionパラメーターの値が無効な場合に返されるエラーメッセージ。 パラメーターに有効な値を指定します。 このパラメーターの値は2 ~ 256文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 値は文字で始まる必要があります。
400InvalidStorage. フォーマット指定されたストレージは無効です。Storageパラメーターの値が無効な場合に返されるエラーメッセージ。 パラメーターに有効な値を指定します。
400InvalidDBInstanceConnType. フォーマット指定されたDBインスタンスのconnタイプは無効です。インスタンスのネットワークタイプがこの操作をサポートしていない場合に返されるエラーメッセージ。
400PreCheckInvalidCreateDdrInstance PreCheckが無効です CreateDdrInstance操作の事前チェックが無効な場合に返されるエラーメッセージ。
400IncorrectDBInstanceType現在のDBインスタンスエンジンとタイプは操作をサポートしていません。この操作がデータベースエンジンとインスタンスのインスタンスタイプでサポートされていない場合に返されるエラーメッセージ。
400InvalidRestoreType. フォーマット指定された復元タイプは無効です。指定された復元タイプが無効な場合に返されるエラーメッセージ。 有効な復元タイプを指定します。
400NoBackupSetRegionBackupSetRegionは不在です。バックアップ領域が存在しない場合に返されるエラーメッセージ。
400NoBaksetNameBaksetNameは存在しません。バックアップセットの名前が存在しない場合に返されるエラーメッセージ。
400NoSourceInstanceNameSourceDBInstanceNameはありません。ソースインスタンスの名前が見つからない場合に返されるエラーメッセージ。
400NoAvailableDisasterRestoreBakset利用可能な災害復元baksetがありません。使用可能なバックアップセットが見つからない場合に返されるエラーメッセージ。
400InvalidBackupType.Format指定されたバックアップの種類が有効ではありません。バックアップタイプが無効な場合に返されるエラーメッセージ。
400IncorrectEngineVersion現在のエンジンバージョンは操作をサポートしていません。インスタンスで実行されているデータベースエンジンバージョンでは、この操作がサポートされていない場合に返されるエラーメッセージ。
400DisasterRestoreRegionNotMatchedディザスタリストアは、ddrリージョンまたはソースリージョンで操作する必要があります。ディザスタリカバリをソースインスタンスまたはターゲットインスタンスのリージョンで実行する必要がある場合に返されるエラーメッセージ。
403IncorrectBackupSetMethod現在のバックアップセットメソッドは操作をサポートしていません。指定されたバックアップセットを使用して個々のデータベースとテーブルを復元できない場合に返されるエラーメッセージ。
403IncorrectBaksetVersion現在のbaksetバージョンは操作をサポートしていません。バックアップセットのバージョンで操作がサポートされていない場合に返されるエラーメッセージ。
403CrossRegionUnsupportTDEクロスリージョンディザスタリストアはTDE baksetをサポートしていません。TDEベースのバックアップセットを使用してインスタンスを別のリージョンに復元できない場合に返されるエラーメッセージ。
404InvalidRegion.NotFound指定されたリージョンがRDSに存在しないリージョンIDが無効な場合に返されるエラーメッセージ。
404InvalidClusterName.NotFound指定されたクラスター名は使用できません。クラスター名が存在しない場合に返されるエラーメッセージ。 クラスター名を確認して、もう一度お試しください。
404InvalidDBInstanceClass.NotFound指定された DB インスタンスクラスが見つかりません。新しいインスタンスタイプが見つからないか、購入できなくなった場合に返されるエラーメッセージ。 使用可能なインスタンスタイプを選択します。
404InvalidDBInstanceNetType.NotFound指定された DB インスタンスネットタイプが見つかりません。インスタンスのネットワークタイプが無効な場合に返されるエラーメッセージ。 ネットワークタイプを確認します。
404RestoreType.NotFoundRestoreTypeが見つかりません。指定された復元方法が存在しない場合に返されるエラーメッセージ。
404InvalidBackupSetID.NotFound指定されたバックアップセットIDが存在しません。指定されたバックアップセットが存在しない場合に返されるエラーメッセージ。 既存のバックアップセットを確認する必要があります。

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