Tous les produits
Search
Centre de documentation

:Interroger les détails d'une tâche de migration vers le cloud

Dernière mise à jour :Aug 19, 2026

Appelez l'opération DescribeCloudMigrationResult pour interroger les détails des tâches de migration vers le cloud d'une instance ApsaraDB RDS for PostgreSQL.

Prérequis

Avant d'appeler l'opération DescribeCloudMigrationResult, assurez-vous d'avoir créé les tâches de migration vers le cloud en appelant l'opération CreateCloudMigrationTask.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. Il génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter Type Required Example Description
Action String Yes DescribeCloudMigrationResult

Opération à effectuer. Définissez la valeur sur DescribeCloudMigrationResult.

DBInstanceName String Yes pgm-bp102g323jd4****

ID de l'instance. Appelez l'opération DescribeDBInstances pour récupérer l'ID de l'instance.

TaskId Long No 440437220

ID de la tâche. Récupérez l'ID dans la réponse renvoyée par l'opération CreateCloudMigrationTask lors de la création de la tâche.

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

Nom de la tâche. Récupérez le nom dans la réponse renvoyée par l'opération CreateCloudMigrationTask lors de la création de la tâche.

SourceIpAddress String No 172,16.XX.XX

Adresse IP privée utilisée pour se connecter à l'instance PostgreSQL autogérée.

  • Si l'instance PostgreSQL autogérée réside sur une instance Elastic Compute Service (ECS), saisissez l'adresse IP privée de l'instance ECS. Pour plus d'informations, consultez View IP addresses.
  • Si l'instance PostgreSQL autogérée réside dans un centre de données sur site, saisissez l'adresse IP privée du centre de données sur site.
  • Si l'instance PostgreSQL autogérée réside sur un appareil connecté via Internet, saisissez l'adresse IP publique de l'appareil.
SourcePort Long No 5432

Numéro de port utilisé pour se connecter à l'instance PostgreSQL autogérée. Exécutez la commande netstat -a | grep PGSQL pour obtenir le numéro de port.

PageNumber Long Yes 10

Numéro de la page à renvoyer.

PageSize Long Yes 1

Nombre d'entrées à renvoyer par page.

Paramètres de réponse

Parameter Type Example Description
TotalSize Integer 1

Nombre total de tâches renvoyées.

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

ID de la requête.

Items Array of Tasks

Tableau contenant les détails des tâches de migration vers le cloud.

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

Heure de création de la tâche.

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

Heure de modification de la tâche.

TaskId Long 440437220

ID de la tâche.

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

Nom de la tâche.

MigrateStage String switch

Phase de migration de la tâche.

  • precheck : précontrôle
  • basebackup : sauvegarde complète des données
  • startup : établissement de la connexion
  • increment : synchronisation des données incrémentielles
  • switch : basculement déclenché par la migration vers le cloud
  • success : migration vers le cloud terminée
SourceCategory String ecsonvpc

Environnement d'exécution de l'instance PostgreSQL autogérée.

  • idcOnVpc : L'instance PostgreSQL autogérée réside dans un centre de données sur site capable de communiquer avec le VPC (Virtual Private Cloud) de l'instance ApsaraDB RDS for PostgreSQL.
  • ecsOnVpc : L'instance PostgreSQL autogérée réside sur une instance ECS.
  • internet : L'instance PostgreSQL autogérée réside sur un appareil connecté via Internet.
SourceIpAddress String 172,16.XX.XX

Adresse IP privée utilisée pour se connecter à l'instance PostgreSQL autogérée.

SourcePort Long 5432

Numéro de port utilisé pour se connecter à l'instance PostgreSQL autogérée.

SourceAccount String migratetest

Nom d'utilisateur du compte utilisé pour la migration vers le cloud.

SourcePassword String 123456

Mot de passe du compte indiqué ci-dessus.

TargetEip String null

Paramètre réservé. La valeur de retour est null.

TargetInstanceName String pgm-bp102g323jd4****

ID de l'instance.

ReplicationState String streaming

État de la réplication des données.

  • unstarted
  • catchup
  • streaming
  • disconnect
  • finish
ReplicationInfo String {\"Status\":\"streaming\",\"ReceiveStartLsn\":\"0/3000000\",\"ReceivedTli\":\"1\",\"LatestEndTime\":\"2022-02-25 17:03:59.3344+08\",\"Synced\":\"true\",\"IsSlave\":\"true\",\"ReplayTimestamp\":\"null\",\"LastMsgSendTime\":\"2022-03-01 14:42:57.967537+08\",\"Conninfo\":\"user=migratetest password=******** channel_binding=prefer dbname=replication host=172.16.254.203 port=5432 application_name=rds_db_instance fallback_application_name=walreceiver sslmode=prefer sslcompression=1 sslsni=1 ssl_min_protocol_version=TLSv1.2 gssencmode=prefer krbsrvname=postgres target_session_attrs=any\",\"LastMsgReceiptTime\":\"2022-03-01 14:42:57.96727+08\",\"LatestEndLsn\":\"0/3000148\",\"ReceivedLsn\":\"0/3000148\",\"ReplayLsn\":\"0/3000148\",\"ReceiveStartTli\":\"1\",\"ReplayLag\":\"0\"}

Informations relatives au lien de réplication.

Detail 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 createrole privilege: success\nCheck account monitor privilege: success\n[Check source version]\nCheck major version consistent: success\n[Check source glibc version]\nCheck source glibc version compatible: warning(warning:source glibc version is not compatible with rds pg)\n[Check disk size]\nCheck disk size enough: success\n[Check wal keep size]\nCheck wal keep size large enough: success\n[Check spec params]\nCheck if spec params too large: success\n[Start RDS instance]\n2022-02-25 17:00:29 --- Start RDS instance as slave for data replication\n[Synchronize data]\n2022-02-25 17:01:05 --- Synchronize data from source to RDS by streaming replication \n

Détails de la tâche.

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

Heure du basculement.

PageNumber Long 1

Numéro de la page renvoyée.

PageSize Long 10

Nombre d'entrées renvoyées par page.

Exemples

Exemples de requêtes

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
&PageNumber=10
&PageSize=1
&<Common request parameters>

Exemples de réponses réussies

Format 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>increment</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>streaming</ReplicationState>
        <ReplicationInfo>{\"Status\":\"streaming\",\"ReceiveStartLsn\":\"0/3000000\",\"ReceivedTli\":\"1\",\"LatestEndTime\":\"2022-02-25 17:03:59.3344+08\",\"Synced\":\"true\",\"IsSlave\":\"true\",\"ReplayTimestamp\":\"null\",\"LastMsgSendTime\":\"2022-03-01 14:42:57.967537+08\",\"Conninfo\":\"user=migratetest password=******** channel_binding=prefer dbname=replication host=172.16.254.203 port=5432 application_name=rds_db_instance fallback_application_name=walreceiver sslmode=prefer sslcompression=1 sslsni=1 ssl_min_protocol_version=TLSv1.2 gssencmode=prefer krbsrvname=postgres target_session_attrs=any\",\"LastMsgReceiptTime\":\"2022-03-01 14:42:57.96727+08\",\"LatestEndLsn\":\"0/3000148\",\"ReceivedLsn\":\"0/3000148\",\"ReplayLsn\":\"0/3000148\",\"ReceiveStartTli\":\"1\",\"ReplayLag\":\"0\"}</ReplicationInfo>
        <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 privilege: success\nCheck account createrole privilege: success\nCheck account monitor privilege: success\n[Check source version]\nCheck major version consistent: success\n[Check source glibc version]\nCheck source glibc version compatible: warning(warning:source glibc version is not compatible with rds pg)\n[Check disk size]\nCheck disk size enough: success\n[Check wal keep size]\nCheck wal keep size large enough: success\n[Check spec params]\nCheck if spec params too large: success\n[Start RDS instance]\n2022-02-25 17:00:29 --- Start RDS instance as slave for data replication\n[Synchronize data]\n2022-02-25 17:01:05 --- Synchronize data from source to RDS by streaming replication \n</Detail>
        <SwitchTime>2022-03-01T06:40:51Z</SwitchTime>
    </Items>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
</DescribeCloudMigrationResultResponse>

Format JSON

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

{
  "TotalSize" : 1,
  "RequestId" : "1B983C48-9793-5EAA-8F7F-00EAEC517675",
  "Items" : {
    "GmtCreated" : "2022-02-25T08:53:13Z",
    "GmtModified" : "2022-03-01T06:39:51Z",
    "TaskId" : 440437220,
    "TaskName" : "362c6c7a-4d20-4eac-898c-1495ceab374c",
    "MigrateStage" : "increment",
    "SourceCategory" : "ecsonvpc",
    "SourceIpAddress" : "172.16.XX.XX",
    "SourcePort" : 5432,
    "SourceAccount" : "migratetest",
    "SourcePassword" : 123456,
    "TargetEip" : "null",
    "TargetInstanceName" : "pgm-bp102g323jd4****",
    "ReplicationState" : "streaming",
    "ReplicationInfo" : "{\\\"Status\\\":\\\"streaming\\\",\\\"ReceiveStartLsn\\\":\\\"0/3000000\\\",\\\"ReceivedTli\\\":\\\"1\\\",\\\"LatestEndTime\\\":\\\"2022-02-25 17:03:59.3344+08\\\",\\\"Synced\\\":\\\"true\\\",\\\"IsSlave\\\":\\\"true\\\",\\\"ReplayTimestamp\\\":\\\"null\\\",\\\"LastMsgSendTime\\\":\\\"2022-03-01 14:42:57.967537+08\\\",\\\"Conninfo\\\":\\\"user=migratetest password=******** channel_binding=prefer dbname=replication host=172.16.254.203 port=5432 application_name=rds_db_instance fallback_application_name=walreceiver sslmode=prefer sslcompression=1 sslsni=1 ssl_min_protocol_version=TLSv1.2 gssencmode=prefer krbsrvname=postgres target_session_attrs=any\\\",\\\"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 privilege: success\\nCheck account createrole privilege: success\\nCheck account monitor privilege: success\\n[Check source version]\\nCheck major version consistent: success\\n[Check source glibc version]\\nCheck source glibc version compatible: warning(warning:source glibc version is not compatible with rds pg)\\n[Check disk size]\\nCheck disk size enough: success\\n[Check wal keep size]\\nCheck wal keep size large enough: success\\n[Check spec params]\\nCheck if spec params too large: success\\n[Start RDS instance]\\n2022-02-25 17:00:29 --- Start RDS instance as slave for data replication\\n[Synchronize data]\\n2022-02-25 17:01:05 --- Synchronize data from source to RDS by streaming replication \\n",
    "SwitchTime" : "2022-03-01T06:40:51Z"
  },
  "PageNumber" : 1,
  "PageSize" : 10
}

Codes d'erreur

HTTP status code

Error code

Error message

Description

404

InvalidDBInstanceName.NotFound

The database instance does not exist.

Le message d'erreur indique que le nom d'instance spécifié est introuvable. Vérifiez le nom de l'instance et réessayez.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.