DescribeCloudMigrationPrecheckResult操作を呼び出して、ApsaraDB RDS for PostgreSQLインスタンスへのクラウド移行の評価レポートをクエリできます。
前提条件
DescribeCloudMigrationPrecheckResult操作を呼び出す前に、CreateCloudMigrationPrecheckTask操作を呼び出して、ApsaraDB RDS for PostgreSQLインスタンスのクラウド移行評価タスクを作成します。
デバッグ
リクエストパラメーター
| 項目 | データ型 | 必須/任意 | 例: | 説明 |
|---|---|---|---|---|
| 操作 | 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アドレス。
|
| 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インスタンスが実行される環境。
|
| 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 エラーセンター」をご参照ください。