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

前提条件

RDSインスタンスは次の要件を満たしています。

  • RDSインスタンスと自己管理型PostgreSQLインスタンスは、PostgreSQL 10、PostgreSQL 11、PostgreSQL 12、PostgreSQL 13、PostgreSQL 14、またはPostgreSQL 15と同じバージョンのPostgreSQLを実行します。
  • RDSインスタンスはプライマリインスタンスです。 読み取り専用RDSインスタンスはクラウド移行をサポートしていません。
  • RDSインスタンスは、標準SSDまたは拡張SSD (ESSD) を使用します。
  • RDSインスタンスは空です。 RDSインスタンスの使用可能なストレージが、自己管理型PostgreSQLインスタンスのデータのサイズ以上であること。

自己管理型PostgreSQLインスタンスは、次の要件を満たしています。

デバッグ

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

リクエストパラメーター

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

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

DBInstanceName String 必須 pgm-bp102g323jd4 ****

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

SourceIpAddress String 必須 172.2.XX.XX

自己管理型PostgreSQLインスタンスへの接続に使用されるプライベートIPアドレス。

  • 自己管理型PostgreSQLインスタンスがECSインスタンスに存在する場合、ECSインスタンスのプライベートIPアドレスを入力します。 ECSインスタンスのプライベートIPアドレスを取得する方法の詳細については、「IPアドレスの表示」をご参照ください。
  • 自己管理型PostgreSQLインスタンスがオンプレミスのデータセンターにある場合は、オンプレミスのデータセンターのプライベートIPアドレスを入力します。
SourcePort Long 〇 5432

自己管理型PostgreSQLインスタンスへの接続に使用されるポート。 ポートを表示するには、netstat -a | grep PGSQLコマンドを実行します。

SourceAccount String 必須 migratetest

アカウントのユーザー名。 [セルフマネージドPostgreSQLインスタンスでのクラウド移行用アカウントの作成] トピックで作成したアカウントのユーザー名を入力します。

SourcePassword String 必須 123456

アカウントのパスワードを入力します。 [セルフマネージドPostgreSQLインスタンスでのクラウド移行用アカウントの作成] トピックで作成したアカウントのパスワードを入力します。

TaskName String 任意 slf7w7wj3g

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

SourceCategory String 必須 ecsOnVpc

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

  • idcOnVpc: 自己管理型PostgreSQLインスタンスはデータセンターにあり、ApsaraDB RDS for PostgreSQLインスタンスが属するVPCと通信できます。
  • ecsOnVpc: 自己管理型PostgreSQLインスタンスはECSインスタンス上にあります。
  • internet: 自己管理型PostgreSQLインスタンスは、インターネット経由で接続されているデバイスに存在します。

レスポンスパラメーター

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

インスタンスの名前です。

RequestId String 60F9A12A-16B8-4728-B099-4CA38D32C31C

リクエストの ID です。
TaskId Long 439946016

クラウド移行タスクのID。

TaskName String slf7w7wj3g

クラウド移行タスクの名前。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=CreateCloudMigrationPrecheckTask
&DBInstanceName=pgm-bp102g323jd4 ****
&SourceIpAddress=172.2.XX.XX
&SourcePort=5432
&SourceAccount=migratetest
&SourcePassword=123456
&タスク名=slf7w7wj3g
&SourceCategory=ecsOnVpc
&共通リクエストパラメータ

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

XML 形式

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

<CreateCloudMigrationPrecheckTaskResponse>
    <DBInstanceName>pgm-bp102g323jd4 ****</DBInstanceName>
    <RequestId>60F9A12A-16B8-4728-B099-4CA38D32C31C</RequestId>
    <TaskId>439946016</TaskId>
    <TaskName>slf7w7wj3g</TaskName>
</CreateCloudMigrationPrecheckTaskResponse>

JSON 形式

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

{
  "DBInstanceName" : "pgm-bp102g323jd4 ****" 、
  "RequestId" : "60F9A12A-16B8-4728-B099-4CA38D32C31C" 、
  "TaskId" : 439946016、
  "TaskName" : "slf7w7wj3g"
}

エラーコード

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

エラーコードの一覧については、「サービスエラーコード」をご参照ください。