DescribeCloudMigrationPrecheckResult操作を呼び出して、ApsaraDB RDS for PostgreSQLインスタンスへのクラウド移行の評価レポートをクエリできます。

前提条件

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

デバッグ

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

リクエストパラメーター

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

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

DBInstanceName String 必須 pgm-bp102g323jd4 ****

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

TaskId Long いいえ 439946016

クラウド移行タスクのID。 CreateCloudMigrationPrecheckTaskを呼び出してタスクを作成した後に返される応答から、タスクのIDを取得できます。

TaskName String 任意 slf7w7wj3g

クラウド移行タスクの名前。 CreateCloudMigrationPrecheckTaskを呼び出してタスクを作成した後に返される応答から、タスクの名前を取得できます。

SourceIpAddress String 任意 172.2.XX.XX

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

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

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

PageSize Long 10

各ページで返されるエントリ数。

PageNumber Long 1

返されるページ数。

レスポンスパラメーター

項目 データ型 例: 説明 
TotalSize Integer 1

エントリの総数。

RequestId String 7E4A6E1B-789B-5F16-9736-39AA57FC7374

リクエストの ID です。

項目 migrateCloudTaskListの配列

評価レポートの詳細。

GmtCreated String 2022-02-25T06:57:41Z

タスクが作成された時刻。

GmtModified String 2022-02-25T06:58:00Z

タスクが変更された時刻。

TaskId Long 440420798

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

TaskName String lxbv6rtxno8

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

SourceCategory String ecsonvpc

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

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

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

SourcePort Long 5432

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

SourceAccount String migratetest

アカウントのユーザー名。

SourcePassword String 123456

アカウントのパスワードを入力します。

TargetEip String null

予約済みのパラメーター。 このパラメーターの戻り値はnullです。

TargetInstanceName String pgm-bp102g323jd4 ****

インスタンスの ID です。

詳細 String [Check rds empty]\nCheck rds databases: success\n [Check source connectivity]\nCheck ip connectable: success\nCheck port connectable: success\nCheck database connectable: success\nCheck account replication privilege: success\nCheck account monitor privilege: success\n success\n [Check source glibc version]\n Check source glibc version compatible: warning(warning:source glibc version is not compatible with rds pg) success\n [トリガーのチェック]\nトリガーの互換性のチェック: 成功 \n [ユーザー機能のチェック]\nユーザー機能の互換性のチェック: 成功 \n * チェックの成功 *

評価レポートの内容。

PageNumber Long 1

返されたページ数。

PageSize Long 10

1 ページあたりで返されるエントリ数。

リクエストの例

http(s):// rds.aliyuncs.com/?Action=DescribeCloudMigrationPrecheckResult
&DBInstanceName=pgm-bp102g323jd4 ****
&TaskId=439946016
&タスク名=slf7w7wj3g
&SourceIpAddress=172.2.XX.XX
&SourcePort=5432
&PageSize=10
&PageNumber=1
&共通リクエストパラメータ

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

XML 形式

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

<DescribeCloudMigrationPrecheckResultResponse>
    <TotalSize>1</TotalSize>
    <RequestId>7E4A6E1B-789B-5F16-9736-39AA57FC7374</RequestId>
    <Items>
        <GmtCreated>2022-02-25T06:57:41Z</GmtCreated>
        <GmtModified>2022-02-25T06:58:00Z</GmtModified>
        <TaskId>440420798</TaskId>
        <TaskName>lxbv6rtxno8</TaskName>
        <SourceCategory>ecsonvpc</SourceCategory>
        <SourceIpAddress>172.2.XX.XX</SourceIpAddress>
        <SourcePort>5432</SourcePort>
        <SourceAccount>migratetest</SourceAccount>
        <SourcePassword>123456</SourcePassword>
        <TargetInstanceName>pgm-bp102g323jd4 ****</TargetInstanceName>
        <詳細>[Check rds empty]\nCheck rds databases: success\n [Check source connectivity]\nCheck ip connectable: success\nCheck port connectable: success\nCheck database connectable: success\nCheck account replication privilege: success\n [Check source version]\nmajor version consistent: success\n [Check source glibc version]\n Check source glibc version compatible: warning(warning:source glibc version is not compatible with rds pg) success\n [トリガーのチェック]\nトリガー互換性のチェック: 成功 \n [ユーザー機能のチェック]\nユーザー機能互換性のチェック: 成功 \n * チェックの成功 *</Detail>
    </Items>
    <ページ番号> 1 </ PAGENUMBER>
    <PageSize>10</PageSize>
</DescribeCloudMigrationPrecheckResultResponse>

JSON 形式

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

{
  "TotalSize" : 1、
  "RequestId" : "7E4A6E1B-789B-5F16-9736-39AA57FC7374" 、
  "アイテム" : {
    "GmtCreated" : "2022-02-25T06:57:41Z" 、
    "GmtModified" : "2022-02-25T06:58:00Z" 、
    "TaskId" : 440420798、
    "TaskName" : "lxbv6rtxno8" 、
    "SourceCategory" : "ecsonvpc" 、
    "SourceIpAddress" : "172.2.XX.XX" 、
    "SourcePort" : 5432、
    "SourceAccount" : "migratetest" 、
    "SourcePassword" : 123456、
    "TargetInstanceName" : "pgm-bp102g323jd4 ****" 、
    "Detail" : "[Check rds empty]\\nCheck rds databases: success\\n [Check source connectivity]\\nCheck ip connectable: success\\nCheck port connectable: success\\nCheck database connectable: success\\nCheck account replication特権: success\\nCheck account createrole特権: 成功 \success\\n [ソースバージョンの確認]\\nメジャーバージョンの一貫性を確認: success\\n [ソースglibcバージョンの確認]\\nソースglibcバージョンの互換性を確認: 警告 (警告: source glibcバージョンはrds pgと互換性がありません)\\n [ディスクサイズを確認]\\\nディスクサイズを十分に確認: success\\n [チェックワールキープサイズ]\\nチェックワールキープサイズが十分に大きい: success\\n [チェックスペックパラメータ]\\nスペックパラメータが大きすぎるかどうかをチェック: success\\n [チェックトリガーズ]\\n [チェックユーザファンクションのチェック]\\\n [チェックユーザファンクションのチェック]\\n
  },
  "PageNumber" : 1,
  "PageSize" : 10
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明 
404 InvalidDBInstanceName.NotFound データベースインスタンスが存在しません。 インスタンスの名前が見つからない場合に返されるエラーメッセージ。 インスタンス名を確認し、もう一度お試しください。

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