Consulta del estado de una tarea de migración de datos - Data Transmission Service

Este tema describe cómo consultar el estado de una tarea de migración de datos mediante una operación de API heredada.

Prueba

Puede llamar a esta operación directamente en OpenAPI Explorer. Esto elimina la necesidad de calcular firmas. Después de una llamada exitosa, OpenAPI Explorer genera automáticamente código de ejemplo para diversos kits de desarrollo de software (SDK).

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeMigrationJobStatus	Parámetro obligatorio. Establezca el valor en DescribeMigrationJobStatus.
RegionId	String	No	cn-hangzhou	ID de la región donde reside la instancia de migración de datos. Para obtener más información, consulte Supported regions.
MigrationJobId	String	Sí	dtsxxxxxxxx	ID de la instancia de migración de datos. Puede llamar a la operación DescribeMigrationJobs para consultar el ID de la instancia.
ClientToken	String	No	ETnLKlblzczshOTUbOCzxxxxxxxxxx	Token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el token, pero debe asegurarse de que sea único entre diferentes solicitudes. El parámetro ClientToken solo puede contener caracteres ASCII y no puede exceder los 64 caracteres de longitud.
AccountId	String	No	12323344****	ID de la cuenta de Alibaba Cloud. No necesita especificar este parámetro. Está previsto que quede obsoleto.
ResourceGroupId	String	No	rg-acfmzawhxxc****	ID del resource group.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	A032E3B4-929B-48E9-97B9-37587CBF****	ID de la solicitud.
MigrationJobName	String	MySQL Migration	Nombre de la instancia de migración de datos.
MigrationJobStatus	String	Migrating	Estado de la tarea de migración de datos. Valores válidos: NotStarted: La tarea no ha iniciado. Prechecking: Se está realizando la comprobación previa de la tarea. PrecheckFailed: La tarea falló en la comprobación previa. Migrating: La tarea está migrando datos. Suspending: La tarea está en pausa. MigrationFailed: La tarea falló al migrar datos. Finished: La tarea ha finalizado.
ErrCode	String	InternalError	Código de error devuelto si la llamada falla.
Success	String	true	Indica si la llamada fue exitosa.
PayType	String	PostPaid	Método de facturación de la tarea de migración de datos. El valor es fijo como PostPaid, lo que indica el método de facturación pay-as-you-go.
ErrMessage	String	The request processing has failed due to some unknown error.	Mensaje de error devuelto si la llamada falla.
MigrationObject	String	[{\"DBName\":\"dtstestdata\",\"TableIncludes\":[{\"TableName\":\"customer\"}]}]	Objetos que se migran.
MigrationJobId	String	dtsxxxxxxxx	ID de la instancia de migración de datos.
TaskId	String	z2v12jfo309****	ID de la tarea de migración de datos.
MigrationJobClass	String	2xlarge	Especificaciones de la instancia de migración de datos. Valores válidos: small, medium, large, xlarge y 2xlarge. Para obtener más información, consulte Specifications of data migration instances.
DataInitializationStatus	Object		Estado de la sincronización inicial completa de datos.
Status	String	Finished	Estado de la sincronización inicial completa de datos. Valores válidos: NotStarted: No iniciada. Migrating: En curso. Failed: Con errores. Finished: Completada.
Percent	String	100	Progreso de la sincronización inicial completa de datos. Unidad: porcentaje.
ErrorMessage	String	java.lang.NumberFormatException: For input string: ""	Mensaje de error devuelto si falla la sincronización inicial completa de datos.
Progress	String	200,001	Número de registros sincronizados durante la sincronización inicial completa de datos.
DataSynchronizationStatus	Object		Estado de la migración incremental de datos.
Status	String	Catched	Estado de la migración incremental de datos. Valores válidos: NotStarted: No iniciada. Migrating: En curso. Failed: Con errores. Finished: Completada. Catched: Sin latencia.
Percent	String	95	Progreso de la migración incremental de datos. Unidad: porcentaje.
Delay	String	0	Latencia de la migración incremental de datos. Unidad: segundos.
ErrorMessage	String	The task failed and cannot be recovered.	Mensaje de error devuelto si falla la migración incremental de datos.
Checkpoint	String	1,571,040,679	Marca de tiempo UNIX de los últimos datos incrementales migrados. Unidad: segundos.
DestinationEndpoint	Object		Configuración de conexión de la instancia de destino.
DatabaseName	String	dtstestdata	Nombre de la base de datos a la que pertenece el objeto de migración en la instancia de destino.
InstanceId	String	rm-bpxxxxxxxx	ID de la instancia de destino.
IP	String	172.16.88.***	Endpoint de la instancia de destino.
InstanceType	String	RDS	Tipo de la instancia de destino.
Port	String	3306	Puerto de servicio de base de datos de la instancia de destino.
UserName	String	dtstest	Cuenta de base de datos de la instancia de destino.
oracleSID	String	testsid	ID del sistema (SID) de la base de datos Oracle. Nota Este parámetro se devuelve solo si el tipo de base de datos de la instancia de destino es Oracle.
EngineName	String	MySQL	Tipo de base de datos de la instancia de destino.
MigrationMode	Object		Tipos de migración.
dataInitialization	Boolean	true	Indica si se realiza la sincronización inicial completa de datos. Valores válidos: true: Sí. false: No.
dataSynchronization	Boolean	false.	Indica si se realiza la migración incremental de datos. Valores válidos: true: Sí. false: No.
structureInitialization	Boolean	false.	Indica si se realiza la migración de esquema. Valores válidos: true: Sí. false: No.
PrecheckStatus	Object		Resultados de la comprobación previa.
Status	String	Success	Estado de la comprobación previa. Valores válidos: NotStarted: No iniciada. Checking: En curso. Failed: Con errores. Finished: Completada.
Percent	String	100	Progreso general de la comprobación previa. Unidad: porcentaje.
Detail	Array of CheckItem		Resultados de comprobación de cada elemento de la verificación previa.
CheckItem
CheckStatus	String	Success	Resultado de la comprobación. Valores válidos: Success: La tarea pasó la comprobación. Failed: La tarea falló en la comprobación.
ErrorMessage	String	Original error: Access denied for user 'dtstest'@'100.104.*.' (using password: YES)	Mensaje de error devuelto si la tarea falla en la comprobación previa. Nota Este parámetro se devuelve solo si el valor del parámetro CheckStatus es Failed.
ItemName	String	CHECK_CONN_SRC	Elemento de la comprobación previa.
RepairMethod	String	CHECK_ERROR_DEST_CONN_REPAIR2	Método para corregir el fallo de la comprobación previa. Nota Este parámetro se devuelve solo si el valor del parámetro CheckStatus es Failed.
SourceEndpoint	Object		Configuración de conexión de la instancia de origen.
DatabaseName	String	dtstestdatabase	Nombre de la base de datos a la que pertenece el objeto de migración en la instancia de origen.
InstanceId	String	rm-bp1i99e8l7913****	ID de la instancia de origen.
IP	String	172.16.88.***	Endpoint de la instancia de origen.
InstanceType	String	RDS	Tipo de la instancia de origen. Valores válidos: RDS: Instancia de ApsaraDB RDS. ECS: Base de datos autogestionada alojada en una instancia ECS. LocalInstance: Base de datos autogestionada con una dirección IP pública. Express: Base de datos autogestionada conectada mediante una línea dedicada, VPN Gateway o Smart Access Gateway. MongoDB: Instancia de ApsaraDB for MongoDB. POLARDB: Clúster de PolarDB for MySQL. Este valor solo está disponible en el sitio web de Alibaba Cloud China (www.aliyun.com).
Port	String	3306	Puerto de servicio de base de datos de la instancia de origen.
UserName	String	dtstest	Cuenta de base de datos de la instancia de origen.
oracleSID	String	testsid	SID de la base de datos Oracle. Nota Este parámetro se devuelve solo cuando el tipo de la base de datos de origen es Oracle.
EngineName	String	MySQL	Tipo de base de datos de la instancia de origen.
StructureInitializationStatus	Object		Estado de la migración de esquema.
Status	String	Finished	Estado de la migración de esquema. Valores válidos: NotStarted: No iniciada. Migrating: En curso. Failed: Con errores. Finished: Completada.
Percent	String	100	Progreso de la migración de esquema. Unidad: porcentaje.
ErrorMessage	String	DTS-1020042 Execute sql error sql: ERROR: type "geometry" does not exist;	Mensaje de error devuelto si falla la migración de esquema.
Progress	String	1	Número de tablas cuyos esquemas se han migrado.

Ejemplos

Solicitudes de ejemplo

Respuestas exitosas de ejemplo

Formato JSON

HTTP/1.1 200 OK

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	Throttling.User	Request was denied due to user flow control.	La solicitud se denegó debido al control de flujo de usuario. Inténtelo de nuevo más tarde.
403	InvalidSecurityToken.Expired	Specified SecurityToken is expired.	El token de seguridad especificado ha expirado. Actualice la firma.
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.	La solicitud falló porque el servidor agotó el tiempo de espera o no estaba disponible. Reintente la solicitud. Si el problema persiste, póngase en contacto con el soporte técnico.

Para obtener más códigos de error, consulte el Centro de errores.