MigrateToOtherZone操作を呼び出して、同じリージョンに属する複数のゾーンにインスタンスを移行できます。

この操作の前提条件は、インスタンスによって実行されるデータベースエンジンによって異なります。 詳細については、以下のトピックをご参照ください。

説明 この操作により、同じリージョンに属する複数のゾーンにインスタンスを移行できます。 この操作では、異なるリージョンに属する複数のゾーンにインスタンスを移行することはできません。 たとえば、中国 (杭州) リージョンのゾーンから中国 (青島) リージョンのゾーンにインスタンスを移行することはできません。

デバッグ

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

リクエストパラメーター

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

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

DBInstanceIdString必須rm-uf6wjk5xxxxxxxxxx

インスタンスの ID です。 DescribeDBInstancesを呼び出して、インスタンスIDを照会できます。

VPCIdString任意vpc-xxxxxxx

インスタンスが属する仮想プライベートクラウド (VPC) のID。 インスタンスのVPCを変更しないでください。

説明
  • インスタンスがVPCにある場合、このパラメーターを指定する必要があります。
  • インスタンスがSQL Serverを実行している場合、インスタンスのVPCを変更できます。
ZoneIdString必須cn-hangzhou-d

宛先ゾーンのID。 DescribeRegionsを呼び出して、ゾーンIDを照会できます。

EffectiveTimeString任意即時

変更を有効にする時刻。 有効な値：

  • すぐに: 変更はすぐに有効になります。 デフォルト値です。
  • MaintainTime: 変更は、計画されたメンテナンス期間中に有効になります。 詳細については、「ModifyDBInstanceMaintainTime」をご参照ください。
  • ScheduleTime: 変更は、指定した時点で有効になります。
説明 このパラメーターをScheduleTimeに設定した場合、SwitchTimeパラメーターを指定する必要があります。
VSwitchIdString任意vsw-uf6adz52c2pxxxxxxx

VSwitch の ID です。

説明
  • インスタンスがVPCにある場合、このパラメーターを指定する必要があります。 DescribeVSwitch操作を呼び出して、vSwitch IDを照会できます。
  • インスタンスがPostgreSQLまたはSQL Serverを実行していて、インスタンスにセカンダリゾーンが指定されている場合は、それぞれがゾーンに対応する複数のvSwitch IDを指定できます。 vSwitch IDはコンマ (,) で区切ります。
カテゴリーString任意高可用性

インスタンスのRDSエディション。 有効な値：

  • 基本: RDSベーシックエディション
  • 高可用性: RDS高可用性エディション
  • AlwaysOn: RDSクラスターエディション
  • ファイナンス: RDS Enterprise Edition
ZoneIdSlave1String任意cn-hangzhou-d

インスタンスのセカンダリゾーン1。

説明 インスタンスがRDS Basic Editionを実行しない場合、このパラメーターを指定する必要があります。
ZoneIdSlave2String任意cn-hangzhou

インスタンスのセカンダリゾーン2。

説明 このパラメーターは、インスタンスがRDS Enterprise Editionを実行している場合にのみ指定できます。
SwitchTimeString任意2021-12-14T15:15:15Z

変更を有効にする時点。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。

説明 このパラメーターは、EffectiveTimeパラメーターと共に使用されます。 このパラメーターは、EffectiveTimeパラメーターがScheduleTimeに設定されている場合にのみ指定する必要があります。
IsModifySpecString任意真実

移行中にインスタンスの仕様を変更するかどうかを指定します。 有効な値：

  • true: 移行中にインスタンスの仕様を変更しません。 このパラメーターをtrueに設定した場合、DBInstanceClassパラメーターとDBInstanceStorageパラメーターの少なくとも1つを指定する必要があります。
  • false: 移行中にインスタンスの仕様を変更します。 デフォルト値です。
説明 このパラメーターは、MySQLを実行するインスタンスに対してのみ有効です。
DBInstanceClassString任意mysql.x4.xlarge.2

インスタンスの新しいインスタンスタイプ。 インスタンスのインスタンスタイプを変更できます。 インスタンスのストレージタイプは変更できません。

IsModifySpecパラメーターをtrueに設定した場合、DBInstanceClassパラメーターとDBInstanceStorageパラメーターの少なくとも1つを指定する必要があります。

インスタンスタイプの詳細については、「Primary Asparagus RDS For MySQLインスタンスタイプ」をご参照ください。

DBInstanceStorageLongいいえ500

インスタンスの新しいストレージ容量。 IsModifySpecパラメーターをtrueに設定した場合、DBInstanceStorageパラメーターとDBInstanceClassパラメーターの少なくとも1つを指定する必要があります。

単位 : GB

使用可能なストレージ容量の範囲は、インスタンスの仕様によって異なります。 詳細については、「プライマリApsaraDB RDS For MySQLインスタンスタイプ」をご参照ください。

レスポンスパラメーター

項目データ型例:説明
RequestIdString65BDA532-28AF-4122-AA39-B382721EEE64

リクエストの ID です。

DBInstanceIdStringrm-uf6wjk5xxxxxxxxxx

インスタンスの ID です。

OrderIdLong213341575990728

注文 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 ステータスコードエラーコードエラーメッセージ説明
400RenewChange。存在する現在のInstanceIdはRDSで更新されました。インスタンスの仕様が変更中の場合に返されるエラーメッセージ。 変更が完了するまで待ってから、もう一度お試しください。
400InvalidMigrateModifyClassOrStorage指定されたパラメータDBInstanceClassまたはストレージが無効です。DBInstanceClassパラメーターまたはDBInstanceStorageパラメーターの値が無効な場合に返されるエラーメッセージ。
400EngineNotSupported指定されたエンジンは操作をサポートできません。インスタンスで実行されているデータベースエンジンでこの操作がサポートされていない場合に返されるエラーメッセージ。 マイナーエンジンのバージョンを更新する必要があります。
400IncorrectDBInstanceLockMode.ValueNotSupported現在のDBインスタンスロックモードは、この操作をサポートしていません。インスタンスが現在のロックモードの場合、この操作がサポートされていない場合に返されるエラーメッセージ。
400InvalidZoneId.NotNullZoneIdパラメーターはnullまたはautoであってはなりません。ZoneIdパラメーターの値がnullまたはautoの場合に返されるエラーメッセージ。
400InvalidZoneId.NotEqualパラメータZoneIdは前のものと同じですこの宛先ゾーンがソースゾーンと同じである場合に返されるエラーメッセージ。
400IncorrectDBInstanceType現在のDBインスタンスタイプは、この操作をサポートしていません。インスタンスが現在の状態の場合、この操作がサポートされていない場合に返されるエラーメッセージ。
400不十分なResourceCapacityCheck事前チェックで要求されたインスタンスに使用できる容量が不足しています。指定されたインスタンスに十分なストレージがなく、事前チェックに失敗した場合に返されるエラーメッセージ。
400IncorrectDBInstanceState現在のDBインスタンスの状態は、この操作をサポートしていません。インスタンスが現在の状態の場合、この操作がサポートされていない場合に返されるエラーメッセージ。
400SSLInstanceNotSupportThisOperationSSLを開いたインスタンス、アップグレードはこの操作ではありませんSSL暗号化機能が有効になっているインスタンスでは、この操作がサポートされていない場合に返されるエラーメッセージ。
400BYOLInstanceNotSupportThisOperationBYOLインスタンスはこの操作をサポートしていませんBring Your Own License (BYOL) を使用するインスタンスではこの操作がサポートされていない場合に返されるエラーメッセージ。
400BYOKInstanceNotSupportThisOperationBYOKインスタンスはこの操作をサポートしていませんディスク暗号化が有効になっているインスタンスでは、操作がサポートされていない場合に返されるエラーメッセージ。
400ADInstanceNotSupportThisOperationADインスタンスはこの操作をサポートしていませんActive Directory (AD) ドメインに追加されたインスタンスでは、この操作がサポートされていない場合に返されるエラーメッセージ。
400TDEInstanceNotSupportThisOperationインスタンスがTDEを開きました。この操作はサポートされていません透過的データ暗号化 (TDE) 機能が有効になっているインスタンスでは、この操作がサポートされていない場合に返されるエラーメッセージ。
400InstanceIsSnapshotBackupNotSupportThisOperationインスタンスのバックアップ方法はスナップショットバックアップです。この操作はサポートされていませんスナップショットバックアップ機能が有効になっているインスタンスでは、この操作がサポートされていない場合に返されるエラーメッセージ。
400InstanceHasReadOnlyInstanceNotSupportThisOperationインスタンスに読み取り専用インスタンスがあるか、読み取り専用インスタンスです。この操作はサポートされていません読み取り専用インスタンスまたは読み取り専用インスタンスがアタッチされているインスタンスでは、この操作がサポートされていない場合に返されるエラーメッセージ。
400VswitchIpExhausted指定されたvswitchで使用可能なipがありません。指定されたvSwitchに使用可能なIPアドレスがない場合に返されるエラーメッセージ。
400OperationDenied.MasterDBInstanceStateマスターインスタンスの状態が原因で操作が許可されていません。プライマリインスタンスが現在の状態の場合、この操作はサポートされていないため、エラーメッセージが返されました。 プライマリインスタンスが [実行中] 状態であることを確認し、再試行します。
400InvalidShareInstance.NotSupport共有dbInstanceはサポートされていません。共有インスタンスがサポートされていない場合に返されるエラーメッセージ。
400InvalidZoneIdSlave1.MissingZoneIdSlave1パラメーターを指定する必要があります。セカンダリゾーンのIDが指定されていない場合に返されるエラーメッセージ。
400MigrateAlreadyExistsFaultrdsインスタンスにはすでに特定のvpc移行タスクがあります。インスタンスに対してVPC移行タスクが作成された場合に返されるエラーメッセージ。
400InvalidInstanceKind.NotSupportインスタンス種類はこの操作をサポートしていません。この操作がインスタンスの構成でサポートされていない場合に返されるエラーメッセージ。
400MissingCategoryインスタンスにカテゴリパラメーターがありません。インスタンスにCategoryパラメーターが指定されていない場合に返されるエラーメッセージ。
400InvalidInstanceNodeType.NotFound指定されたNodeTypeが見つかりません。NodeTypeパラメーターが指定されていない場合に返されるエラーメッセージ。 パラメーターを指定します。
400EngineVersionNotSupported指定されたEngineVersionは、ソースDBインスタンスとレプリケートできません。エンジンバージョンがインスタンスの複製をサポートしていない場合に返されるエラーメッセージ。
400CommodityCodeNotFoundCommodityCodeNotFoundCommodityCodeパラメーターの値が無効な場合に返されるエラーメッセージ。 有効な値を入力して、もう一度お試しください。
403OperationDenied.OutofUsageリソースは使用不能です。指定されたゾーンが十分なリソースを提供していない場合に返されるエラーメッセージ。 別のゾーンを選択する必要があります。
403IncorrectEffectiveTime指定されたEffectiveTimeパラメーターは無効です。EffectiveTimeパラメーターの値が無効な場合に返されるエラーメッセージ。
403InvalidTempInstance.NotSupporttemp dbインスタンスはサポートされていません。インスタンスがロックされている場合に返されるエラーメッセージ。
403OperationDenied.LockModeインスタンスがロックされているため、操作は許可されていません。インスタンスがロックされている場合、この操作がサポートされていない場合に返されるエラーメッセージ。 インスタンスのストレージ容量が使い果たされていないか、またはインスタンスの有効期限が切れていないかを確認します。 インスタンスのストレージ容量が使い果たされた場合は、インスタンスの仕様を変更してストレージ容量を拡張し、インスタンスのロックが解除されるまで待ってから、再試行してください。 インスタンスの有効期限が切れた場合は、インスタンスを更新し、インスタンスのロックが解除されるまで待ってから、再試行してください。
403ClassicNetworkType.NotSupportClassic インスタンスのネットワーク作成はサポートされていません。クラシックネットワークタイプのインスタンスを作成できない場合に返されるエラーメッセージ。 Create an instance of another network type.
403InstanceNetworkTypeNotFoundFault指定されたDBInstanceNetworkTypeが見つかりません。インスタンスがネットワークタイプチェックに失敗した場合に返されるエラーメッセージ。 インスタンスのネットワークタイプが存在しません。
403ProprietaryCloud.NotSupported独自のクラウドはサポートされていません。Apsara Stackがサポートされていない場合に返されるエラーメッセージ。
403MigrateAlreadyReadWriteSplitExistsFaultrdsインスタンスにはすでに特定のvpc移行タスクがあります。インスタンスに対してVPC移行タスクが作成された場合に返されるエラーメッセージ
403InvalidRegionAvzNotFound指定されたユーザーがリージョンとavzを見つけられません。指定されたユーザーがインスタンスのリージョンまたはゾーンを見つけることができない場合に返されるエラーメッセージ。
403ZoneIdNotSupportedゾーンIDはサポートされていません。ZoneIdパラメーターで指定されたゾーンがサポートされていない場合に返されるエラーメッセージ。
404InvalidDBInstanceName.NotFoundデータベースインスタンスが存在しません。インスタンスの名前が見つからない場合に返されるエラーメッセージ。 名前が正しいかどうかを確認してください。
404IncorrectVswitchId指定されたパラメーターVSwitchIdは無効です。VSwitchIdパラメーターの値が無効な場合に返されるエラーメッセージ。

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