CreateDdrInstance操作を呼び出して、インスタンスのデータを別のリージョンにある新しいインスタンスに復元できます。
この操作を呼び出す前に、CheckCreateDdrDBInstance操作を呼び出して、ソースインスタンスのデータをクロスリージョンバックアップファイルから復元できるかどうかを確認できます。
この操作を呼び出す前に、インスタンスが次のデータベースエンジンのいずれかを実行していることを確認してください。
- MySQL。 詳細については、「ApsaraDB RDS For MySQLインスタンスのリージョン間のバックアップ」をご参照ください。
- SQL Server。 詳細については、「ApsaraDB RDS For SQL Serverインスタンスのリージョン間のバックアップ」をご参照ください。
- 配布キーを修正します。 詳細については、「ApsaraDB RDS For PostgreSQLインスタンスのリージョン間のバックアップ」をご参照ください。
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
操作 | String | 必須 | CreateDdrInstance | 実行する操作です。 値をCreateDdrInstanceに設定します。 |
RegionId | String | 必須 | cn-hangzhou | ターゲットインスタンスのリージョンID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。 |
Engine | String | 必須 | MySQL | ターゲットインスタンスのデータベースエンジン。 有効な値:
|
EngineVersion | String | 必須 | 5.6 | ターゲットインスタンスのメジャーエンジンバージョン。 このパラメーターの値は、Engineパラメーターの値によって異なります。 有効な値:
|
DBInstanceClass | String | 必須 | rds.mysql.s1.small | ターゲットインスタンスのインスタンスタイプ。 詳細については、「プライマリApsaraDB RDSインスタンスタイプ」をご参照ください。 |
DBInstanceStorage | Integer | 〇 | 20 | ターゲットインスタンスのストレージ容量。 有効な値: 5 ~ 2000 単位 : GB この値は5 GBの倍数である必要があります。 詳細については、「プライマリApsaraDB RDSインスタンスタイプ」をご参照ください。 |
SystemDBCharset | String | 任意 | uft8 | ターゲットインスタンスの文字セット。 有効な値:
|
DBInstanceNetType | String | 必須 | イントラネット | 宛先インスタンスのネットワーク接続タイプ。 有効な値:
|
DBInstanceDescription | String | 任意 | testdatabase | ターゲットインスタンスの名前。 名前は2 ~ 256文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は英字とする必要があります。 説明 名前は http:// または https:// で始めることはできません。 |
SecurityIPList | String | 必須 | 127.0.0.1 | ターゲットインスタンスのIPアドレスホワイトリスト。 IPアドレスホワイトリストに複数のエントリを追加する場合は、エントリをコンマ (,) で区切ります。 各エントリは一意である必要があります。 最大1,000個のエントリを追加できます。 詳細については、「ApsaraDB RDS For MySQLインスタンスのIPアドレスホワイトリストの設定」をご参照ください。 IPアドレスホワイトリストのエントリは、次のいずれかの形式である必要があります。
|
ClientToken | String | 任意 | ETnLKlblzczshOTUbOCzxxxxxxxxxx | リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、生成されたトークンが異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。 |
PayType | String | 必須 | プリペイド | ターゲットインスタンスの課金方法。 有効な値:
|
ZoneId | String | 任意 | cn-hangzhou-d | ターゲットインスタンスのゾーンID。 ターゲットインスタンスが複数のゾーンにデプロイされている場合は、ゾーンのIDをコロン (:) で区切ります。 説明 仮想プライベートクラウド (VPC) とvSwitchを指定する場合は、ZoneIdパラメーターも指定する必要があります。 |
InstanceNetworkType | String | 任意 | Classic | ターゲットインスタンスのネットワークタイプ。 有効な値:
デフォルト値: Classic。 説明 このパラメーターをVPCに設定した場合、VPCIdおよびVSwitchIdパラメーターも指定する必要があります。 |
ConnectionMode | String | 任意 | スタンダード | 接続先インスタンスの接続モード。 有効な値:
デフォルト値: Standard |
VPCId | String | 任意 | vpc-xxxxxxxxxxxx | ターゲットインスタンスのVPC ID。 このパラメーターは、InstanceNetworkTypeパラメーターをVPCに設定した場合にのみ使用できます。 説明 このパラメーターを指定する場合は、ZoneIdパラメーターも指定する必要があります。 |
VSwitchId | String | 任意 | vsw-xxxxxxxxxxx | ターゲットインスタンスのvSwitch ID。 複数のvSwitchを指定する場合は、vSwitchのIDをカンマ(,)で区切ってください。このパラメータは、 InstanceNetworkType パラメータを VPCに設定した場合のみ利用可能です。. 説明 このパラメーターを指定する場合は、ZoneIdパラメーターも指定する必要があります。 |
PrivateIpAddress | String | 任意 | 172.XXX.XXX.69 | ターゲットインスタンスのプライベートIPアドレス。 プライベートIPアドレスは、指定されたvSwitchでサポートされているCIDRブロック内にある必要があります。 システムは、 VPCId と VSwitchId パラメータの値に基づいて、インスタンスに自動的にプライベートIPアドレスを割り当てます。 |
UsedTime | String | × | 2 | インスタンスのサブスクリプション期間。 有効な値:
説明 PayTypeパラメーターを前払いに設定した場合、このパラメーターも指定する必要があります。 |
期間 | String | 任意 | 年 | ターゲットインスタンスのサブスクリプション期間を測定するために使用される単位。 有効な値:
説明 PayTypeパラメーターを前払いに設定した場合、このパラメーターも指定する必要があります。 |
ResourceGroupId | String | 任意 | rg-acfmyxxxxxxxxxx | リソースグループの ID です。 |
RestoreType | String | 必須 | BackupSet | データの復元に使用されるメソッド。 有効な値:
|
BackupSetId | String | 任意 | 14 *** | 復元に使用するバックアップセットのIDです。DescribeCrossRegionBackupsを呼び出して、バックアップセットのIDを照会できます。 説明 RestoreType パラメータを BackupSetに設定した場合、このパラメータも指定する必要があります。 |
RestoreTime | String | 任意 | 2019-05-30T03:29:10Z | データを復元する時点。 指定する時点は、現在の時刻より前である必要があります。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。 説明 RestoreTypeパラメーターをBackupTimeに設定した場合、このパラメーターも指定する必要があります。 |
SourceRegion | String | 任意 | cn-hangzhou | データをある時点に復元する場合の復元元インスタンスの地域ID。 説明 RestoreTypeパラメーターをBackupTimeに設定した場合、このパラメーターも指定する必要があります。 |
SourceDBInstanceName | String | 任意 | rm-uf6wjk5xxxxxxx | データをある時点に復元する場合のソースインスタンスのID。 説明 RestoreTypeパラメーターをBackupTimeに設定した場合、このパラメーターも指定する必要があります。 |
DBInstanceStorageType | String | 任意 | local_ssd | ターゲットインスタンスのストレージタイプ。 ローカルSSDストレージタイプのみがサポートされています。 デフォルト値: local_ssd |
レスポンスパラメーター
項目 | データ型 | 例: | 説明 |
---|---|---|---|
DBInstanceId | String | rm-xxxxx | ターゲットインスタンスの ID。 |
RequestId | String | E52666CC-330E-418A-8E5B-A19E3FB42D13 | リクエストの ID です。 |
ポート | String | 3306 | 宛先インスタンスへの接続に使用されるポート番号。 説明 DBInstanceNetTypeパラメーターは、ポートが内部ポートかパブリックポートかを示します。 |
ConnectionString | String | rm-xxxxx.mysql.rds.aliyuncs.com | ターゲットインスタンスへの接続に使用されるエンドポイント。 説明 DBInstanceNetTypeパラメーターは、エンドポイントが内部エンドポイントかパブリックエンドポイントかを示します。 |
OrderId | String | 2038691xxxxx | 注文 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 ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | InvalidZoneId.NotSupported | 指定されたvpcゾーンはサポートされていません。 | 指定されたゾーンでVPCにインスタンスを作成できない場合に返されるエラーメッセージ。 別のゾーンを指定して、もう一度お試しください。 |
400 | InvalidDBInstanceName. フォーマット | 指定された DB インスタンス名は無効です。 | インスタンスが存在しない場合に返されるエラーメッセージ。 インスタンス情報を確認します。 |
400 | InvalidDBInstanceName.Duplicate | 指定された DB インスタンス名は、既に RDS に存在します。 | インスタンス名が既に存在する場合に返されるエラーメッセージ。 別の名前を指定して、もう一度お試しください。 |
400 | InvalidRegion. フォーマット | 指定されたリージョンは無効です。 | 指定されたリージョンが無効な場合に返されるエラーメッセージ。 |
400 | InvalidServiceType. フォーマット | 指定されたサービスタイプは無効です。 | サービスタイプが無効な場合に返されるエラーメッセージ: サービスタイプを0または1に設定します。 値0はAlibaba Cloudサービスを示し、値1はJSTサービスを示します。 |
400 | InvalidEngine.Malformed | 指定されたエンジンは無効です。 | データベースエンジンが無効な場合に返されるエラーメッセージ。 有効なデータベースエンジンを指定します。 |
400 | InvalidEngineVersion.Malformed | 指定されたエンジンバージョンが無効です。 | 指定されたデータベースエンジンのバージョンが無効な場合に返されるエラーメッセージ。 データベースエンジンのバージョンを確認して、もう一度お試しください。 |
400 | InvalidConnectionString. フォーマット | 指定された接続文字列は無効です。 | エンドポイントのプレフィックスが無効な場合に返されるエラーメッセージ。 プレフィックスの長さは5 ~ 40文字である必要があります。 |
400 | InvalidConnectionString.Duplicate | 指定された接続文字列は既にAliyun RDS に存在します。 | 指定したエンドポイントが既に存在する場合に返されるエラーメッセージ。 別のエンドポイントを指定します。 |
400 | InvalidCharacterSetName. フォーマット | 指定された文字セット名は無効です。 | 指定された文字セットが無効な場合に返されるエラーメッセージ。 ApsaraDB RDSは、GBK、UTF-8、EUC-KR、およびASCIIの文字セットをサポートしています。 |
400 | InvalidDBInstanceType. フォーマット | 指定されたインスタンスタイプは無効です。 | 指定されたインスタンスタイプが無効な場合に表示されるエラーメッセージ。 インスタンスタイプを選択し直してください。 |
400 | InvalidPort.Malformed | 指定されたポートが有効でない。 | 指定したポート番号が無効な場合に返されるエラーメッセージ。 |
400 | InvalidBackupRetentionPeriod.Malformed | 指定されたバックアップ保存期間が有効ではありません。 | 指定されたバックアップサイクルが無効な場合に返されるエラーメッセージ。 バックアップサイクルは、1日を超えるか、30日以下である必要があります。 |
400 | InvalidPreferredBackupTime.Format | 指定された優先バックアップ時刻が無効です。 | バックアップ時刻の形式が正しくない場合に返されるエラーメッセージ。 時間をYYYY-MM-DDThh:mmZ形式でGMTで指定します。 例: 2012-06-11T15:00Z。 |
400 | InvalidPreferredBackupPeriod.Malformed | 指定されたバックアップ期間は無効です。 | バックアップ時刻が無効な場合に返されるエラーメッセージ。 |
400 | InvalidExpiredTime. フォーマット | 指定された有効期限は無効です。 | ExpiredTimeパラメーターの値が無効な場合に返されるエラーメッセージ。 the yyyy-MM-ddTHH:mm:ssZ 形式で時刻を指定します。 時間は UTC にする必要があります。 |
400 | InvalidSecurityIPList.Format | 指定されたセキュリティIPリストの形式が無効です。 | IPアドレスホワイトリストが無効な場合に返されるエラーメッセージ。 IPアドレスホワイトリストを確認します。 |
400 | InvalidSecurityIPList.Duplicate | 指定されたセキュリティIPリストが無効: リスト内の重複IPアドレス | 指定されたIPアドレスまたはCIDRブロックが無効な場合に返されるエラーメッセージ。 指定されたIPアドレスまたはCIDRブロックが重複しています。 |
400 | InvalidSecurityIPList.QuotaExceeded | 指定されたセキュリティIPリストは無効です: リスト内のIPアドレスの許容量を超えています。 | 指定されたIPアドレスホワイトリストのエントリ数が上限を超えた場合に返されるエラーメッセージ。 IPアドレスホワイトリストには、最大1,000個のエントリを指定できます。 |
400 | InvalidDBInstanceDescription.Format | 指定された DB インスタンスの説明は無効です。 | DBInstanceDescriptionパラメーターの値が無効な場合に返されるエラーメッセージ。 パラメーターに有効な値を指定します。 このパラメーターの値は2 ~ 256文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 値は文字で始まる必要があります。 |
400 | InvalidStorage. フォーマット | 指定されたストレージは無効です。 | Storageパラメーターの値が無効な場合に返されるエラーメッセージ。 パラメーターに有効な値を指定します。 |
400 | InvalidDBInstanceConnType. フォーマット | 指定されたDBインスタンスのconnタイプは無効です。 | インスタンスのネットワークタイプがこの操作をサポートしていない場合に返されるエラーメッセージ。 |
400 | PreCheckInvalid | CreateDdrInstance PreCheckが無効です | CreateDdrInstance操作の事前チェックが無効な場合に返されるエラーメッセージ。 |
400 | IncorrectDBInstanceType | 現在のDBインスタンスエンジンとタイプは操作をサポートしていません。 | この操作がデータベースエンジンとインスタンスのインスタンスタイプでサポートされていない場合に返されるエラーメッセージ。 |
400 | InvalidRestoreType. フォーマット | 指定された復元タイプは無効です。 | 指定された復元タイプが無効な場合に返されるエラーメッセージ。 有効な復元タイプを指定します。 |
400 | NoBackupSetRegion | BackupSetRegionは不在です。 | バックアップ領域が存在しない場合に返されるエラーメッセージ。 |
400 | NoBaksetName | BaksetNameは存在しません。 | バックアップセットの名前が存在しない場合に返されるエラーメッセージ。 |
400 | NoSourceInstanceName | SourceDBInstanceNameはありません。 | ソースインスタンスの名前が見つからない場合に返されるエラーメッセージ。 |
400 | NoAvailableDisasterRestoreBakset | 利用可能な災害復元baksetがありません。 | 使用可能なバックアップセットが見つからない場合に返されるエラーメッセージ。 |
400 | InvalidBackupType.Format | 指定されたバックアップの種類が有効ではありません。 | バックアップタイプが無効な場合に返されるエラーメッセージ。 |
400 | IncorrectEngineVersion | 現在のエンジンバージョンは操作をサポートしていません。 | インスタンスで実行されているデータベースエンジンバージョンでは、この操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | DisasterRestoreRegionNotMatched | ディザスタリストアは、ddrリージョンまたはソースリージョンで操作する必要があります。 | ディザスタリカバリをソースインスタンスまたはターゲットインスタンスのリージョンで実行する必要がある場合に返されるエラーメッセージ。 |
403 | IncorrectBackupSetMethod | 現在のバックアップセットメソッドは操作をサポートしていません。 | 指定されたバックアップセットを使用して個々のデータベースとテーブルを復元できない場合に返されるエラーメッセージ。 |
403 | IncorrectBaksetVersion | 現在のbaksetバージョンは操作をサポートしていません。 | バックアップセットのバージョンで操作がサポートされていない場合に返されるエラーメッセージ。 |
403 | CrossRegionUnsupportTDE | クロスリージョンディザスタリストアはTDE baksetをサポートしていません。 | TDEベースのバックアップセットを使用してインスタンスを別のリージョンに復元できない場合に返されるエラーメッセージ。 |
404 | InvalidRegion.NotFound | 指定されたリージョンがRDSに存在しない | リージョンIDが無効な場合に返されるエラーメッセージ。 |
404 | InvalidClusterName.NotFound | 指定されたクラスター名は使用できません。 | クラスター名が存在しない場合に返されるエラーメッセージ。 クラスター名を確認して、もう一度お試しください。 |
404 | InvalidDBInstanceClass.NotFound | 指定された DB インスタンスクラスが見つかりません。 | 新しいインスタンスタイプが見つからないか、購入できなくなった場合に返されるエラーメッセージ。 使用可能なインスタンスタイプを選択します。 |
404 | InvalidDBInstanceNetType.NotFound | 指定された DB インスタンスネットタイプが見つかりません。 | インスタンスのネットワークタイプが無効な場合に返されるエラーメッセージ。 ネットワークタイプを確認します。 |
404 | RestoreType.NotFound | RestoreTypeが見つかりません。 | 指定された復元方法が存在しない場合に返されるエラーメッセージ。 |
404 | InvalidBackupSetID.NotFound | 指定されたバックアップセットIDが存在しません。 | 指定されたバックアップセットが存在しない場合に返されるエラーメッセージ。 既存のバックアップセットを確認する必要があります。 |
エラーコードの一覧については、「サービスエラーコード」をご参照ください。