Tous les produits
Search
Centre de documentation

Data Transmission Service:Interroger l'état d'une tâche de migration de données

Dernière mise à jour :Aug 10, 2026

Cette rubrique explique comment interroger l'état d'une tâche de migration de données à l'aide d'une ancienne opération API.

Test

Appelez cette opération directement dans OpenAPI Explorer. Vous n'avez pas besoin de calculer les signatures. Après un appel réussi, OpenAPI Explorer génère automatiquement des exemples de code pour divers kits de développement logiciel (SDK).

Paramètres de la requête

Paramètre

Type

Obligatoire

Exemple

Description

Action String Oui DescribeMigrationJobStatus

Paramètre obligatoire. Définissez la valeur sur DescribeMigrationJobStatus.

RegionId String Non cn-hangzhou

ID de la région où réside l'instance de migration de données. Pour plus d'informations, consultez Régions prises en charge.

MigrationJobId String Oui dtsxxxxxxxx

ID de l'instance de migration de données. Appelez l'opération DescribeMigrationJobs pour interroger l'ID de l'instance.

ClientToken String Non ETnLKlblzczshOTUbOCzxxxxxxxxxx

Jeton client utilisé pour garantir l'idempotence de la requête. Générez le jeton via le client, en veillant à ce qu'il soit unique pour chaque requête. Le paramètre ClientToken ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères.

AccountId String Non 12323344****

ID du compte Alibaba Cloud. Il n'est pas nécessaire de spécifier ce paramètre. Ce paramètre est destiné à être obsolète.

ResourceGroupId String Non rg-acfmzawhxxc****

ID du groupe de ressources.

Paramètres de réponse

Paramètre

Type

Exemple

Description

RequestId String A032E3B4-929B-48E9-97B9-37587CBF****

ID de la requête.

MigrationJobName String MySQL Migration

Nom de l'instance de migration de données.

MigrationJobStatus String Migrating

État de la tâche de migration de données. Valeurs possibles :

  • NotStarted : La tâche n'est pas démarrée.
  • Prechecking : Pré-vérification en cours.
  • PrecheckFailed : Échec de la pré-vérification.
  • Migrating : Migration des données en cours.
  • Suspending : Tâche suspendue.
  • MigrationFailed : Échec de la migration des données.
  • Finished : Tâche terminée.
ErrCode String InternalError

Code d'erreur renvoyé en cas d'échec de l'appel.

Success String true

Indique si l'appel a réussi.

PayType String PostPaid

Méthode de facturation de la tâche de migration de données. La valeur est fixée à PostPaid, ce qui correspond au paiement à l'utilisation.

ErrMessage String The request processing has failed due to some unknown error.

Message d'erreur renvoyé en cas d'échec de l'appel.

MigrationObject String [{\"DBName\":\"dtstestdata\",\"TableIncludes\":[{\"TableName\":\"customer\"}]}]

Objets migrés.

MigrationJobId String dtsxxxxxxxx

ID de l'instance de migration de données.

TaskId String z2v12jfo309****

ID de la tâche de migration de données.

MigrationJobClass String 2xlarge

Spécifications de l'instance de migration de données. Valeurs possibles : small, medium, large, xlarge et 2xlarge. Pour plus d'informations, consultez Spécifications des instances de migration de données.

DataInitializationStatus Object

État de la synchronisation initiale des données complètes.

Status String Finished

État de la synchronisation initiale des données complètes. Valeurs possibles :

  • NotStarted : Non démarré.
  • Migrating : En cours.
  • Failed : Échec.
  • Finished : Terminé.
Percent String 100

Progression de la synchronisation initiale des données complètes. Unité : pourcentage.

ErrorMessage String java.lang.NumberFormatException: For input string: ""

Message d'erreur renvoyé en cas d'échec de la synchronisation initiale des données complètes.

Progress String 200001

Nombre d'enregistrements synchronisés lors de la synchronisation initiale des données complètes.

DataSynchronizationStatus Object

État de la migration incrémentielle des données.

Status String Catched

État de la migration incrémentielle des données. Valeurs possibles :

  • NotStarted : Non démarré.
  • Migrating : En cours.
  • Failed : Échec.
  • Finished : Terminé.
  • Catched : Aucune latence.
Percent String 95

Progression de la migration incrémentielle des données. Unité : pourcentage.

Delay String 0

Latence de la migration incrémentielle des données. Unité : secondes.

ErrorMessage String The task failed and cannot be recovered.

Message d'erreur renvoyé en cas d'échec de la migration incrémentielle des données.

Checkpoint String 1571040679

Horodatage UNIX des dernières données incrémentielles migrées. Unité : secondes.

DestinationEndpoint Object

Paramètres de connexion de l'instance de destination.

DatabaseName String dtstestdata

Nom de la base de données à laquelle appartient l'objet de migration dans l'instance de destination.

InstanceId String rm-bpxxxxxxxx

ID de l'instance de destination.

IP String 172.16.88.***

Endpoint de l'instance de destination.

InstanceType String RDS

Type de l'instance de destination.

Port String 3306

Port du service de base de données de l'instance de destination.

UserName String dtstest

Compte de base de données de l'instance de destination.

oracleSID String testsid

ID système (SID) de la base de données Oracle.

Remarque Ce paramètre est renvoyé uniquement si le type de base de données de l'instance de destination est Oracle.
EngineName String MySQL

Type de base de données de l'instance de destination.

MigrationMode Object

Types de migration.

dataInitialization Boolean true

Indique s'il faut effectuer la synchronisation initiale des données complètes. Valeurs possibles :

  • true : Oui.
  • false : Non.
dataSynchronization Boolean false.

Indique s'il faut effectuer la migration incrémentielle des données. Valeurs possibles :

  • true : Oui.
  • false : Non.
structureInitialization Boolean false.

Indique s'il faut effectuer la migration du schéma. Valeurs possibles :

  • true : Oui.
  • false : Non.
PrecheckStatus Object

Résultats de la pré-vérification.

Status String Success

État de la pré-vérification. Valeurs possibles :

  • NotStarted : Non démarré.
  • Checking : En cours.
  • Failed : Échec.
  • Finished : Terminé.
Percent String 100

Progression globale de la pré-vérification. Unité : pourcentage.

Detail Array of CheckItem

Résultats de la vérification pour chaque élément de pré-vérification.

CheckItem
CheckStatus String Success

Résultat de la vérification. Valeurs possibles :

  • Success : La tâche a passé la vérification.
  • Failed : La tâche a échoué à la vérification.
ErrorMessage String Original error: Access denied for user 'dtstest'@'100.104.***.**' (using password: YES)

Message d'erreur renvoyé si la tâche échoue à la pré-vérification.

Remarque Ce paramètre est renvoyé uniquement si la valeur du paramètre CheckStatus est Failed.
ItemName String CHECK_CONN_SRC

Élément de pré-vérification.

RepairMethod String CHECK_ERROR_DEST_CONN_REPAIR2

Méthode pour corriger l'échec de la pré-vérification.

Remarque Ce paramètre est renvoyé uniquement si la valeur du paramètre CheckStatus est Failed.
SourceEndpoint Object

Paramètres de connexion de l'instance source.

DatabaseName String dtstestdatabase

Nom de la base de données à laquelle appartient l'objet de migration dans l'instance source.

InstanceId String rm-bp1i99e8l7913****

ID de l'instance source.

IP String 172.16.88.***

Endpoint de l'instance source.

InstanceType String RDS

Type de l'instance source. Valeurs possibles :

  • RDS : Instance ApsaraDB RDS.
  • ECS : Base de données auto-gérée hébergée sur une instance ECS.
  • LocalInstance : Base de données auto-gérée avec une adresse IP publique.
  • Express : Base de données auto-gérée connectée via une ligne louée, VPN Gateway ou Smart Access Gateway.
  • MongoDB : Instance ApsaraDB for MongoDB.
  • POLARDB : Cluster PolarDB for MySQL. Cette valeur est disponible uniquement sur le site Web Alibaba Cloud Chine (www.aliyun.com).
Port String 3306

Port du service de base de données de l'instance source.

UserName String dtstest

Compte de base de données de l'instance source.

oracleSID String testsid

SID de la base de données Oracle.

Remarque Ce paramètre est renvoyé uniquement lorsque le type de base de données de la base de données source est Oracle.
EngineName String MySQL

Type de base de données de l'instance source.

StructureInitializationStatus Object

État de la migration du schéma.

Status String Finished

État de la migration du schéma. Valeurs possibles :

  • NotStarted : Non démarré.
  • Migrating : En cours.
  • Failed : Échec.
  • Finished : Terminé.
Percent String 100

Progression de la migration du schéma. Unité : pourcentage.

ErrorMessage String DTS-1020042 Execute sql error sql: ERROR: type "geometry" does not exist;

Message d'erreur renvoyé en cas d'échec de la migration du schéma.

Progress String 1

Nombre de tables dont les schémas ont été migrés.

Exemples

Exemples de requêtes

Exemples de réponses réussies

JSON format

HTTP/1.1 200 OK

Codes d'erreur

HttpCode

Code d'erreur

Message d'erreur

Description

400 Throttling.User Request was denied due to user flow control. La requête est refusée en raison d'un contrôle de flux au niveau de l'utilisateur. Réessayez plus tard.
403 InvalidSecurityToken.Expired Specified SecurityToken is expired. Le jeton de sécurité spécifié a expiré. Mettez à jour la signature.
500 ServiceUnavailable The request has failed due to a temporary failure of the server. La requête a échoué car le serveur a expiré ou était indisponible. Réessayez la requête. Si le problème persiste, contactez le support technique.

Pour plus de codes d'erreur, consultez le Centre d'erreurs.