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

前提条件

DescribeCloudMigrationResult操作を呼び出す前に、CreateCloudMigrationTask操作を呼び出してクラウド移行タスクが作成されていることを確認してください。

デバッグ

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

リクエストパラメーター

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

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

DBInstanceName String 必須 pgm-bp102g323jd4 ****

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

TaskId Long いいえ 440437220

タスクのID。 CreateCloudMigrationTaskを呼び出してタスクを作成したときに返される応答から、タスクのIDを取得できます。

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

タスクの名前。 CreateCloudMigrationTaskを呼び出してタスクを作成したときに返される応答から、タスクの名前を取得できます。

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コマンドを実行して、ポート番号を取得できます。

PageNumber Long 10

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

PageSize Long 1

返されるページ数。

レスポンスパラメーター

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

返されるタスクの総数。

RequestId String 1B983C48-9793-5EAA-8F7F-00EAEC517675

リクエストの ID です。

項目 タスクの配列

クラウド移行タスクに関する詳細で構成される配列。

GmtCreated String 2022-02-25T08:53:13Z

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

GmtModified String 2022-03-01T06:39:51Z

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

TaskId Long 440437220

タスクのID。

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

タスクの名前。

MigrateStage String スイッチ

タスクが留まる移行フェーズ。

  • precheck: precheck
  • basebackup: 完全なデータバックアップ
  • startup: リンクの確立
  • increment: 増分データ同期
  • switch: クラウド移行による切り替え
  • success: クラウド移行完了
SourceCategory String ecsonvpc

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

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

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

SourcePort Long 5432

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

SourceAccount String migratetest

クラウド移行に使用されるアカウントのユーザー名。

SourcePassword String 123456

前のアカウントのパスワード。

TargetEip String null

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

TargetInstanceName String pgm-bp102g323jd4 ****

インスタンスの ID です。

ReplicationState String ストリーミング

データレプリケーションのステータス。

  • 未開始
  • catchup
  • ストリーミング
  • disconnect
  • 仕上げ
ReplicationInfo String {\"Status\":\"streaming\",\"ReceiveStartLsn\":\"0/3000000\",\"ReceivedTli\":\"1\",\"LatestEndTime\":\"2022-02-25 17:03:59.3344 08\",\"Synced\":\"true\" \"true\",\"ReplayTimestamp\":\"null\",\"LastMsgSendTime\":\"2022-03-01 14:42:57.967537 + 08\",\"Conninfo\": "ユーザー=migratetestパスワード=* * * * * channel_binding=好むdbname=複製ホスト=172.16.254.203ポート=5432 application_name=rds_db_instance fallback_application_name=walreceiver sslmode=好むsslcompression=1 sslsni=1 ssl_min_protocol_version=TLSv1.2 gssencmode=好むkrbsrvname=postgres target_session_attrs=任意の" 、"LastMsgReceiptTime": "2022-03-01 14:42:57。96727 + 08" 、"LatestEndLsn":\"0/3000148\" 、\"ReceivedLsn\":\"0/3000148\" 、\"ReplayLsn\":\"0/3000148\" 、\"ReceiveStartTli\":\"1\" 、\"ReplayLag\":\"0\"}

レプリケーションリンクに関する情報。

詳細 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 [RDSインスタンスの起動]\n2022-02-25 17:00:29 --- RDSインスタンスをデータレプリケーションのスレーブとして起動 \n [データの同期]\n2022-02-25 17:01:05 --- ストリーミングレプリケーションによってソースからRDSにデータを同期 \n

タスクに関する詳細。

SwitchTime String 2022-03-01T06:40:51Z

切り替えの時刻。

PageNumber Long 1

返されたページ数。

PageSize Long 10

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

リクエストの例

http(s):// rds.aliyuncs.com/?Action=DescribeCloudMigrationResult
&DBInstanceName=pgm-bp102g323jd4 ****
&TaskId=440437220
&TaskName=362c6c7a-4d20-4eac-898c-1495ceab374c
&SourceIpAddress=172.16.XX.XX
&SourcePort=5432
&ページ番号=10
&PageSize=1
&<共通リクエストパラメーター>

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

XML 形式

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

<DescribeCloudMigrationResultResponse>
    <TotalSize>1</TotalSize>
    <RequestId>1B983C48-9793-5EAA-8F7F-00EAEC517675</RequestId>
    <Items>
        <GmtCreated>2022-02-25T08:53:13Z</GmtCreated>
        <GmtModified>2022-03-01T06:39:51Z</GmtModified>
        <TaskId>440437220</TaskId>
        <TaskName>362c6c7a-4d20-4eac-898c-1495ceab374c</TaskName>
        <MigrateStage> インクリメント </MigrateStage>
        <SourceCategory>ecsonvpc</SourceCategory>
        <SourceIpAddress>172.16.XX.XX</SourceIpAddress>
        <SourcePort>5432</SourcePort>
        <SourceAccount>migratetest</SourceAccount>
        <SourcePassword>123456</SourcePassword>
        <TargetEip>null</TargetEip>
        <TargetInstanceName>pgm-bp102g323jd4 ****</TargetInstanceName>
        <ReplicationState> ストリーミング </ReplicationState>
        <ReplicationInfo >{\ "Status\":\"streaming\" 、\"ReceiveStartLsn\":\"0/3000000\" 、\"ReceivedTli\":\"LatestEndTime\":\"2022-02-25 17:03:59.3344 \" 、\"\" Synced\":\" true\"\" true\",\" ReplayTimestamp\":\" null\",\" LastMsgSendTime\":\" 2022-03-01 14:42:57.967537 + 08\",\" Conninfo\":" ユーザー=migratetestパスワード=* * * * * channel_binding=好むdbname=複製ホスト=172.16.254.203ポート=5432 application_name=rds_db_instance fallback_application_name=walreceiver sslmode=好むsslcompression=1 sslsni=1 ssl_min_protocol_version=TLSv1.2 gssencmode=好むkrbsrvname=postgres target_session_attrs=任意の "、" LastMsgReceiptTime ":" 2022-03-01 14:42:57。96727 + 08 "、" LatestEndLsn ":\" 0/3000148\"、\" ReceivedLsn\":\" 0/3000148\"、\" ReplayLsn\":\" 0/3000148\"、\" ReceiveStartTli\":\" 1\"、\" ReplayLag\":\" 0\"}</ReplicationInfo>
        <詳細>[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 [RDSインスタンスの起動]\n2022-02-25 17:00:29 --- RDSインスタンスをデータレプリケーションのスレーブとして起動 \n [データの同期]\n2022-02-25 17:01:05 --- ストリーミングレプリケーションによってソースからRDSにデータを同期 \n</Detail>
        <SwitchTime>2022-03-01T06:40:51Z</SwitchTime>
    </Items>
    <ページ番号> 1 </ PAGENUMBER>
    <PageSize>10</PageSize>
</DescribeCloudMigrationResultResponse>

JSON 形式

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

{
  "TotalSize" : 1、
  "RequestId" : "1B983C48-9793-5EAA-8F7F-00EAEC517675" 、
  "アイテム" : {
    "GmtCreated" : "2022-02-25T08:53:13Z" 、
    "GmtModified" : "2022-03-01T06:39:51Z" 、
    "TaskId" : 440437220、
    "TaskName" : "362c6c7a-4d20-4eac-898c-1495ceab374c" 、
    "MigrateStage" : "インクリメント" 、
    "SourceCategory" : "ecsonvpc" 、
    "SourceIpAddress" : "172.16.XX.XX" 、
    "SourcePort" : 5432、
    "SourceAccount" : "migratetest" 、
    "SourcePassword" : 123456、
    "TargetEip" : "null" 、
    "TargetInstanceName" : "pgm-bp102g323jd4 ****" 、
    "ReplicationState" : "streaming" 、
    "ReplicationInfo" : "{\\\" Status ":\\\" ストリーミング ",\\\" ReceiveStartLsn ":\\\" 0/3000000 ",\\\" ReceivedTli ":\\\" 1 ",\\\" LatestEndTime ":\\\" 2022-02-25 17:03:59。3344 + 08 ",\\\" Synced ":\\\" 真 ",\\\" IsSlave ":\\\" 真 ",\\\" ReplayTimestamp ":\\\" null ",\\\" LastMsgSendTime ":\\\" 2022-03-01 14:42:57。967537 + 08 ",\\\" Conninfo ":\\\ ユーザー=migratetestパスワード=* * * * * channel_binding=好むdbname=複製ホスト=172.16.254.203ポート=5432 application_name=rds_db_instance fallback_application_name=walreceiver sslmode=好むsslcompression=1 sslsni=1 ssl_min_protocol_version=TLSv1.2 gssencmode=好むkrbsrvname=postgres target_session_attrs=任意の" ,\\\ "LastMsgReceiptTime" :\\\ "2022-03-01 14:42:57。96727 + 08" ,\\\ "LatestEndLsn" :\\\ "0/3000148" ,\\\ "ReceivedLsn" :\\\ "0/3000148" ,\\\ "ReplayLsn" :\\\ "0/3000148" ,\\\ "ReceiveStartTli" :\\\ "1" ,\\\ "ReplayLag" :\\\ "0"}"、
    "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[Check wal keep size]\\nチェックwal keep size enough: success\\n[Check spec params]\\n spec paramsが大きすぎるかどうかを確認してください: success\\n [RDSインスタンスの起動]\\n2022-02-25 17:00:29 --- データレプリケーションのスレーブとしてRDSインスタンスを起動 \\n [データの同期]\\n2022-02-25 17:01:05 --- レプリケーションのストリーミングによってソースからRDSにデータを同期 \\n" 、
    "SwitchTime" : "2022-03-01T06:40:51Z"
  },
  "PageNumber" : 1,
  "PageSize" : 10
}

エラーコード

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

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