CreateCloudMigrationTask操作を呼び出して、ApsaraDB RDS for PostgreSQLインスタンスのクラウド移行タスクを作成できます。

前提条件

この操作を呼び出す前に、ApsaraDB RDS for PostgreSQLインスタンスがクラウド移行評価に合格していることを確認してください。

デバッグ

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

リクエストパラメーター

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

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

DBInstanceName String 必須 pgm-bp102g323jd4 ****

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

SourceIpAddress String 必須 172.16.XX.XX

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

  • 自己管理型PostgreSQLインスタンスがElastic Compute Service (ECS) インスタンスにある場合、ECSインスタンスのプライベートIPアドレスを入力します。 詳細については、「IPアドレスの表示」をご参照ください。
  • 自己管理型PostgreSQLインスタンスがオンプレミスのデータセンターにある場合は、オンプレミスのデータセンターのプライベートIPアドレスを入力します。
  • インターネット経由で接続されているデバイスにある自己管理型PostgreSQLインスタンスで、デバイスのパブリックIPアドレスを入力します。
SourcePort Long 〇 5432

自己管理型PostgreSQLインスタンスへの接続に使用されるポート番号。 netstat -a grep PGSQLコマンドを実行して、ポート番号を取得できます。

SourceAccount String 必須 migratetest

クラウド移行に使用されるアカウントのユーザー名。 詳細については、「セルフマネージドPostgreSQLインスタンスでのクラウド移行用アカウントの作成」をご参照ください。

SourcePassword String 必須 123456

前のアカウントのパスワード。 詳細については、「セルフマネージドPostgreSQLインスタンスでのクラウド移行用アカウントの作成」をご参照ください。

TaskName String 任意 362c6c7a-4d20-4eac-898c-1495ceab374c

タスクの名前。 カスタムタスク名を指定できます。 このパラメーターを指定しない場合、ApsaraDB RDSは自動的にタスク名を生成します。

SourceCategory String 必須 ecsOnVpc

自己管理型PostgreSQLインスタンスが実行される環境。

  • idcOnVpc: 自己管理型PostgreSQLインスタンスはオンプレミスのデータセンターにあり、ApsaraDB RDS for PostgreSQLインスタンスが属する仮想プライベートクラウド (VPC) と通信できます。
  • ecsOnVpc: 自己管理型PostgreSQLインスタンスはECSインスタンス上にあります。
  • internet: 自己管理型PostgreSQLインスタンスは、インターネット経由で接続されているデバイスに存在します。

レスポンスパラメーター

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

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

RequestId String 8B993DA9-5272-5414-94E3-4CA8BA0146C2

リクエストの ID です。

TaskId Long 440437220

タスクのID。

TaskName String 362c6c7a-4d20-4eac-898c-1495ceab374c

タスクの名前。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=CreateCloudMigrationTask
&DBInstanceName=pgm-bp102g323jd4 ****
&SourceIpAddress=172.16.XX.XX
&SourcePort=5432
&SourceAccount=migratetest
&SourcePassword=123456
&TaskName=362c6c7a-4d20-4eac-898c-1495ceab374c
&SourceCategory=ecsOnVpc
&<共通リクエストパラメーター>

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

XML 形式

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

<CreateCloudMigrationTaskResponse>
    <DBInstanceName>pgm-bp102g323jd4 ****</DBInstanceName>
    <RequestId>8B993DA9-5272-5414-94E3-4CA8BA0146C2</RequestId>
    <TaskId>440437220</TaskId>
    <TaskName>362c6c7a-4d20-4eac-898c-1495ceab374c</TaskName>
</CreateCloudMigrationTaskResponse>

JSON 形式

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

{
  "DBInstanceName" : "pgm-bp102g323jd4 ****" 、
  "RequestId" : "8B993DA9-5272-5414-94E3-4CA8BA0146C2" 、
  "TaskId" : 440437220、
  "TaskName" : "362c6c7a-4d20-4eac-898c-1495ceab374c"
}

エラーコード

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

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