ActivateMigrationTargetInstanceを呼び出して、ワークロードをApsaraDB RDS for PostgreSQLインスタンスに切り替えることができます。

前提条件

ActivateMigrationTargetInstance操作を呼び出す前に、CreateCloudMigrationTask操作を呼び出してクラウド移行タスクが作成されていることを確認してください。 さらに、DescribeCloudMigrationResult操作の呼び出しからMigrateStageパラメーターに返される値がincrementであることを確認します。

デバッグ

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

リクエストパラメーター

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

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

DBInstanceName String 必須 pgm-bp102g323jd4 ****

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

SwitchTime String 任意 2022-02-25T06:57:41Z

予約済みのパラメーター。 このパラメータは有効になりません。

SwitchTimeMode String 任意 0

切り替えを実行する時刻。

値を 0 に設定します。 値0は、即時の切り替えを指定します。

ForceSwitch String いいえ 1

強制的に切り替えを実行するかどうかを指定します。 値を1に設定します。 値1は、強制的な切り替えを指定します。

レスポンスパラメーター

項目 データ型 例: 説明
DBInstanceName String pgm-bp102g323jd4 ****

ApsaraDB RDS for PostgreSQLインスタンスの名前。

RequestId String 76364A52-E0AB-5CC8-9818-CF1DC482C092

リクエストの ID です。

TaskId Long 440913675

タスクのID。

SourceIpAddress String 172.16.XX.XX

自己管理型PostgreSQLインスタンスへの接続に使用されるプライベートまたはパブリックIPアドレス。

SourcePort Long 5432

自己管理型PostgreSQLインスタンスへの接続に使用されるポート番号。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=ActivateMigrationTargetInstance
&DBInstanceName=pgm-bp102g323jd4 ****
&SwitchTime=2022-02-25T06:57:41Z
&SwitchTimeMode=0
&ForceSwitch=1
&<共通リクエストパラメーター>

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

XML 形式

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

<ActivateMigrationTargetInstanceResponse>
    <DBInstanceName>pgm-bp102g323jd4 ****</DBInstanceName>
    <RequestId>76364A52-E0AB-5CC8-9818-CF1DC482C092</RequestId>
    <TaskId>440913675</TaskId>
    <SourceIpAddress>172.16.XX.XX</SourceIpAddress>
    <SourcePort>5432</SourcePort>
</ActivateMigrationTargetInstanceResponse>

JSON 形式

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

{
  "DBInstanceName" : "pgm-bp102g323jd4 ****" 、
  "RequestId" : "76364A52-E0AB-5CC8-9818-CF1DC482C092" 、
  "TaskId" : 440913675、
  "SourceIpAddress" : "172.16.XX.XX" 、
  "SourcePort" : 5432
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 IncorrectDBInstanceState 現在のインスタンス状態はこの操作をサポートしていません。 インスタンスが現在の状態の場合、操作がサポートされていない場合に返されるエラーメッセージ。
403 IncorrectDBInstance 現在のDBインスタンスはこの操作をサポートしていません。 操作がインスタンスでサポートされていない場合に返されるエラーメッセージ。
403 IncorrectDBInstanceType データベースインスタンスタイプは操作をサポートしていません。 インスタンスによって実行されるデータベースエンジンで操作がサポートされていない場合に返されるエラーメッセージ。
404 InvalidDBInstanceName.NotFound データベースインスタンスが存在しません。 指定したインスタンス名が見つからない場合に返されるエラーメッセージ。 インスタンス名を確認し、もう一度お試しください。
404 IncorrectDBInstanceLockMode 現在のDBインスタンスロックモードはこの操作に対応していません。 インスタンスがロックされている場合に返されるエラーメッセージ。

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