MigrateToOtherZone操作を呼び出して、同じリージョンに属する複数のゾーンにインスタンスを移行できます。
この操作の前提条件は、インスタンスによって実行されるデータベースエンジンによって異なります。 詳細については、以下のトピックをご参照ください。
- 同じリージョンのゾーン間でApsaraDB RDS for MySQLインスタンスを移行する
- 同じリージョンのゾーン間でApsaraDB RDS for PostgreSQLインスタンスを移行する
- 同じリージョンのゾーン間でApsaraDB RDS for SQL Serverインスタンスを移行する
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
操作 | String | 必須 | MigrateToOtherZone | 実行する操作です。 値をMigrateToOtherZoneに設定します。 |
DBInstanceId | String | 必須 | rm-uf6wjk5xxxxxxxxxx | インスタンスの ID です。 DescribeDBInstancesを呼び出して、インスタンスIDを照会できます。 |
VPCId | String | 任意 | vpc-xxxxxxx | インスタンスが属する仮想プライベートクラウド (VPC) のID。 インスタンスのVPCを変更しないでください。 説明
|
ZoneId | String | 必須 | cn-hangzhou-d | 宛先ゾーンのID。 DescribeRegionsを呼び出して、ゾーンIDを照会できます。 |
EffectiveTime | String | 任意 | 即時 | 変更を有効にする時刻。 有効な値:
説明 このパラメーターをScheduleTimeに設定した場合、SwitchTimeパラメーターを指定する必要があります。 |
VSwitchId | String | 任意 | vsw-uf6adz52c2pxxxxxxx | VSwitch の ID です。 説明
|
カテゴリー | String | 任意 | 高可用性 | インスタンスのRDSエディション。 有効な値:
|
ZoneIdSlave1 | String | 任意 | cn-hangzhou-d | インスタンスのセカンダリゾーン1。 説明 インスタンスがRDS Basic Editionを実行しない場合、このパラメーターを指定する必要があります。 |
ZoneIdSlave2 | String | 任意 | cn-hangzhou | インスタンスのセカンダリゾーン2。 説明 このパラメーターは、インスタンスがRDS Enterprise Editionを実行している場合にのみ指定できます。 |
SwitchTime | String | 任意 | 2021-12-14T15:15:15Z | 変更を有効にする時点。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。 説明 このパラメーターは、EffectiveTimeパラメーターと共に使用されます。 このパラメーターは、EffectiveTimeパラメーターがScheduleTimeに設定されている場合にのみ指定する必要があります。 |
IsModifySpec | String | 任意 | 真実 | 移行中にインスタンスの仕様を変更するかどうかを指定します。 有効な値:
説明 このパラメーターは、MySQLを実行するインスタンスに対してのみ有効です。 |
DBInstanceClass | String | 任意 | mysql.x4.xlarge.2 | インスタンスの新しいインスタンスタイプ。 インスタンスのインスタンスタイプを変更できます。 インスタンスのストレージタイプは変更できません。 IsModifySpecパラメーターをtrueに設定した場合、DBInstanceClassパラメーターとDBInstanceStorageパラメーターの少なくとも1つを指定する必要があります。 インスタンスタイプの詳細については、「Primary Asparagus RDS For MySQLインスタンスタイプ」をご参照ください。 |
DBInstanceStorage | Long | いいえ | 500 | インスタンスの新しいストレージ容量。 IsModifySpecパラメーターをtrueに設定した場合、DBInstanceStorageパラメーターとDBInstanceClassパラメーターの少なくとも1つを指定する必要があります。 単位 : GB 使用可能なストレージ容量の範囲は、インスタンスの仕様によって異なります。 詳細については、「プライマリApsaraDB RDS For MySQLインスタンスタイプ」をご参照ください。 |
レスポンスパラメーター
項目 | データ型 | 例: | 説明 |
---|---|---|---|
RequestId | String | 65BDA532-28AF-4122-AA39-B382721EEE64 | リクエストの ID です。 |
DBInstanceId | String | rm-uf6wjk5xxxxxxxxxx | インスタンスの ID です。 |
OrderId | Long | 213341575990728 | 注文 ID。 このパラメーターは、インスタンスがMySQLを実行する場合にのみ返されます。 |
例
リクエストの例
http(s):// rds.aliyuncs.com/?Action=MigrateToOtherZone
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&ZoneId=cn-hangzhou-b
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
HTTP/1.1 200 OK
Content-Type:application/xml
<MigrateToOtherZoneResponse>
<RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>
<DBInstanceId>rm-uf6wjk5xxxxxxxxxx</DBInstanceId>
</MigrateToOtherZoneResponse>
JSON
形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "65BDA532-28AF-4122-AA39-B382721EEE64" 、
"DBInstanceId" : "rm-uf6wjk5xxxxxxxxxx"
}
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | RenewChange。存在する | 現在のInstanceIdはRDSで更新されました。 | インスタンスの仕様が変更中の場合に返されるエラーメッセージ。 変更が完了するまで待ってから、もう一度お試しください。 |
400 | InvalidMigrateModifyClassOrStorage | 指定されたパラメータDBInstanceClassまたはストレージが無効です。 | DBInstanceClassパラメーターまたはDBInstanceStorageパラメーターの値が無効な場合に返されるエラーメッセージ。 |
400 | EngineNotSupported | 指定されたエンジンは操作をサポートできません。 | インスタンスで実行されているデータベースエンジンでこの操作がサポートされていない場合に返されるエラーメッセージ。 マイナーエンジンのバージョンを更新する必要があります。 |
400 | IncorrectDBInstanceLockMode.ValueNotSupported | 現在のDBインスタンスロックモードは、この操作をサポートしていません。 | インスタンスが現在のロックモードの場合、この操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | InvalidZoneId.NotNull | ZoneIdパラメーターはnullまたはautoであってはなりません。 | ZoneIdパラメーターの値がnullまたはautoの場合に返されるエラーメッセージ。 |
400 | InvalidZoneId.NotEqual | パラメータZoneIdは前のものと同じです | この宛先ゾーンがソースゾーンと同じである場合に返されるエラーメッセージ。 |
400 | IncorrectDBInstanceType | 現在のDBインスタンスタイプは、この操作をサポートしていません。 | インスタンスが現在の状態の場合、この操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | 不十分なResourceCapacityCheck | 事前チェックで要求されたインスタンスに使用できる容量が不足しています。 | 指定されたインスタンスに十分なストレージがなく、事前チェックに失敗した場合に返されるエラーメッセージ。 |
400 | IncorrectDBInstanceState | 現在のDBインスタンスの状態は、この操作をサポートしていません。 | インスタンスが現在の状態の場合、この操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | SSLInstanceNotSupportThisOperation | SSLを開いたインスタンス、アップグレードはこの操作ではありません | SSL暗号化機能が有効になっているインスタンスでは、この操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | BYOLInstanceNotSupportThisOperation | BYOLインスタンスはこの操作をサポートしていません | Bring Your Own License (BYOL) を使用するインスタンスではこの操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | BYOKInstanceNotSupportThisOperation | BYOKインスタンスはこの操作をサポートしていません | ディスク暗号化が有効になっているインスタンスでは、操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | ADInstanceNotSupportThisOperation | ADインスタンスはこの操作をサポートしていません | Active Directory (AD) ドメインに追加されたインスタンスでは、この操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | TDEInstanceNotSupportThisOperation | インスタンスがTDEを開きました。この操作はサポートされていません | 透過的データ暗号化 (TDE) 機能が有効になっているインスタンスでは、この操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | InstanceIsSnapshotBackupNotSupportThisOperation | インスタンスのバックアップ方法はスナップショットバックアップです。この操作はサポートされていません | スナップショットバックアップ機能が有効になっているインスタンスでは、この操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | InstanceHasReadOnlyInstanceNotSupportThisOperation | インスタンスに読み取り専用インスタンスがあるか、読み取り専用インスタンスです。この操作はサポートされていません | 読み取り専用インスタンスまたは読み取り専用インスタンスがアタッチされているインスタンスでは、この操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | VswitchIpExhausted | 指定されたvswitchで使用可能なipがありません。 | 指定されたvSwitchに使用可能なIPアドレスがない場合に返されるエラーメッセージ。 |
400 | OperationDenied.MasterDBInstanceState | マスターインスタンスの状態が原因で操作が許可されていません。 | プライマリインスタンスが現在の状態の場合、この操作はサポートされていないため、エラーメッセージが返されました。 プライマリインスタンスが [実行中] 状態であることを確認し、再試行します。 |
400 | InvalidShareInstance.NotSupport | 共有dbInstanceはサポートされていません。 | 共有インスタンスがサポートされていない場合に返されるエラーメッセージ。 |
400 | InvalidZoneIdSlave1.Missing | ZoneIdSlave1パラメーターを指定する必要があります。 | セカンダリゾーンのIDが指定されていない場合に返されるエラーメッセージ。 |
400 | MigrateAlreadyExistsFault | rdsインスタンスにはすでに特定のvpc移行タスクがあります。 | インスタンスに対してVPC移行タスクが作成された場合に返されるエラーメッセージ。 |
400 | InvalidInstanceKind.NotSupport | インスタンス種類はこの操作をサポートしていません。 | この操作がインスタンスの構成でサポートされていない場合に返されるエラーメッセージ。 |
400 | MissingCategory | インスタンスにカテゴリパラメーターがありません。 | インスタンスにCategoryパラメーターが指定されていない場合に返されるエラーメッセージ。 |
400 | InvalidInstanceNodeType.NotFound | 指定されたNodeTypeが見つかりません。 | NodeTypeパラメーターが指定されていない場合に返されるエラーメッセージ。 パラメーターを指定します。 |
400 | EngineVersionNotSupported | 指定されたEngineVersionは、ソースDBインスタンスとレプリケートできません。 | エンジンバージョンがインスタンスの複製をサポートしていない場合に返されるエラーメッセージ。 |
400 | CommodityCodeNotFound | CommodityCodeNotFound | CommodityCodeパラメーターの値が無効な場合に返されるエラーメッセージ。 有効な値を入力して、もう一度お試しください。 |
403 | OperationDenied.OutofUsage | リソースは使用不能です。 | 指定されたゾーンが十分なリソースを提供していない場合に返されるエラーメッセージ。 別のゾーンを選択する必要があります。 |
403 | IncorrectEffectiveTime | 指定されたEffectiveTimeパラメーターは無効です。 | EffectiveTimeパラメーターの値が無効な場合に返されるエラーメッセージ。 |
403 | InvalidTempInstance.NotSupport | temp dbインスタンスはサポートされていません。 | インスタンスがロックされている場合に返されるエラーメッセージ。 |
403 | OperationDenied.LockMode | インスタンスがロックされているため、操作は許可されていません。 | インスタンスがロックされている場合、この操作がサポートされていない場合に返されるエラーメッセージ。 インスタンスのストレージ容量が使い果たされていないか、またはインスタンスの有効期限が切れていないかを確認します。 インスタンスのストレージ容量が使い果たされた場合は、インスタンスの仕様を変更してストレージ容量を拡張し、インスタンスのロックが解除されるまで待ってから、再試行してください。 インスタンスの有効期限が切れた場合は、インスタンスを更新し、インスタンスのロックが解除されるまで待ってから、再試行してください。 |
403 | ClassicNetworkType.NotSupport | Classic インスタンスのネットワーク作成はサポートされていません。 | クラシックネットワークタイプのインスタンスを作成できない場合に返されるエラーメッセージ。 Create an instance of another network type. |
403 | InstanceNetworkTypeNotFoundFault | 指定されたDBInstanceNetworkTypeが見つかりません。 | インスタンスがネットワークタイプチェックに失敗した場合に返されるエラーメッセージ。 インスタンスのネットワークタイプが存在しません。 |
403 | ProprietaryCloud.NotSupported | 独自のクラウドはサポートされていません。 | Apsara Stackがサポートされていない場合に返されるエラーメッセージ。 |
403 | MigrateAlreadyReadWriteSplitExistsFault | rdsインスタンスにはすでに特定のvpc移行タスクがあります。 | インスタンスに対してVPC移行タスクが作成された場合に返されるエラーメッセージ |
403 | InvalidRegionAvzNotFound | 指定されたユーザーがリージョンとavzを見つけられません。 | 指定されたユーザーがインスタンスのリージョンまたはゾーンを見つけることができない場合に返されるエラーメッセージ。 |
403 | ZoneIdNotSupported | ゾーンIDはサポートされていません。 | ZoneIdパラメーターで指定されたゾーンがサポートされていない場合に返されるエラーメッセージ。 |
404 | InvalidDBInstanceName.NotFound | データベースインスタンスが存在しません。 | インスタンスの名前が見つからない場合に返されるエラーメッセージ。 名前が正しいかどうかを確認してください。 |
404 | IncorrectVswitchId | 指定されたパラメーターVSwitchIdは無効です。 | VSwitchIdパラメーターの値が無効な場合に返されるエラーメッセージ。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。