Todos os produtos
Search
Central de documentação

Data Transmission Service:Consultar o status de uma tarefa de migração de dados

Última atualização: Jun 27, 2026

Este tópico descreve como consultar o status de uma tarefa de migração de dados por meio de uma operação de API legada.

Testar

Chame esta operação diretamente no OpenAPI Explorer para evitar o cálculo manual de assinaturas. Após uma chamada bem-sucedida, o OpenAPI Explorer gera automaticamente códigos de exemplo para vários kits de desenvolvimento de software (SDKs).

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DescribeMigrationJobStatus

Parâmetro obrigatório. Defina o valor como DescribeMigrationJobStatus.

RegionId

String

Não

cn-hangzhou

ID da região onde a instância de migração de dados reside. Para mais informações, consulte Regiões suportadas.

MigrationJobId

String

Sim

dtsxxxxxxxx

ID da instância de migração de dados. Chame a operação DescribeMigrationJobs para consultar o ID da instância.

ClientToken

String

Não

ETnLKlblzczshOTUbOCzxxxxxxxxxx

Token de cliente usado para garantir a idempotência da solicitação. Gere o token no cliente, mas certifique-se de que seja único entre diferentes solicitações. O parâmetro ClientToken aceita apenas caracteres ASCII e não pode exceder 64 caracteres.

AccountId

String

Não

12323344****

ID da conta Alibaba Cloud. Não é necessário especificar este parâmetro. Ele será descontinuado.

ResourceGroupId

String

Não

rg-acfmzawhxxc****

ID do grupo de recursos.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

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

ID da solicitação.

MigrationJobName String MySQL Migration

Nome da instância de migração de dados.

MigrationJobStatus String Migrating

Status da tarefa de migração de dados. Valores válidos:

  • NotStarted: Tarefa não iniciada.
  • Prechecking: Pré-verificação em andamento.
  • PrecheckFailed: Falha na pré-verificação.
  • Migrating: Migração de dados em andamento.
  • Suspending: Tarefa pausada.
  • MigrationFailed: Falha na migração de dados.
  • Finished: Tarefa concluída.
ErrCode String InternalError

Código de erro retornado se a chamada falhar.

Success String true

Indica se a chamada foi bem-sucedida.

PayType String PostPaid

Método de faturamento da tarefa de migração de dados. Valor fixo: PostPaid, que indica pagamento conforme o uso.

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

Mensagem de erro retornada se a chamada falhar.

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

Objetos migrados.

MigrationJobId String dtsxxxxxxxx

ID da instância de migração de dados.

TaskId String z2v12jfo309****

ID da tarefa de migração de dados.

MigrationJobClass String 2xlarge

Especificações da instância de migração de dados. Valores válidos: small, medium, large, xlarge e 2xlarge. Para mais informações, consulte Especificações das instâncias de migração de dados.

DataInitializationStatus Object

Status da sincronização inicial completa de dados.

Status String Finished

Status da sincronização inicial completa de dados. Valores válidos:

  • NotStarted: Não iniciado.
  • Migrating: Em andamento.
  • Failed: Falhou.
  • Finished: Concluído.
Percent String 100

Progresso da sincronização inicial completa de dados. Unidade: porcentagem.

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

Mensagem de erro retornada se a sincronização inicial completa de dados falhar.

Progress String 200001

Número de registros sincronizados durante a sincronização inicial completa de dados.

DataSynchronizationStatus Object

Status da migração incremental de dados.

Status String Catched

Status da migração incremental de dados. Valores válidos:

  • NotStarted: Não iniciado.
  • Migrating: Em andamento.
  • Failed: Falhou.
  • Finished: Concluído.
  • Catched: Sem latência.
Percent String 95

Progresso da migração incremental de dados. Unidade: porcentagem.

Delay String 0

Latência da migração incremental de dados. Unidade: segundos.

ErrorMessage String The task failed and cannot be recovered.

Mensagem de erro retornada se a migração incremental de dados falhar.

Checkpoint String 1571040679

Timestamp UNIX dos últimos dados incrementais migrados. Unidade: segundos.

DestinationEndpoint Object

Configurações de conexão da instância de destino.

DatabaseName String dtstestdata

Nome do banco de dados ao qual o objeto de migração pertence na instância de destino.

InstanceId String rm-bpxxxxxxxx

ID da instância de destino.

IP String 172.16.88.***

Endpoint da instância de destino.

InstanceType String RDS

Tipo da instância de destino.

Port String 3306

Porta de serviço do banco de dados da instância de destino.

UserName String dtstest

Conta do banco de dados da instância de destino.

oracleSID String testsid

System ID (SID) do banco de dados Oracle.

Nota Este parâmetro é retornado apenas se o tipo de banco de dados da instância de destino for Oracle.
EngineName String MySQL

Tipo de banco de dados da instância de destino.

MigrationMode Object

Tipos de migração.

dataInitialization Boolean true

Indica se a sincronização inicial completa de dados deve ser executada. Valores válidos:

  • true: Sim.
  • false: Não.
dataSynchronization Boolean false.

Indica se a migração incremental de dados deve ser executada. Valores válidos:

  • true: Sim.
  • false: Não.
structureInitialization Boolean false.

Indica se a migração de esquema deve ser executada. Valores válidos:

  • true: Sim.
  • false: Não.
PrecheckStatus Object

Resultados da pré-verificação.

Status String Success

Status da pré-verificação. Valores válidos:

  • NotStarted: Não iniciado.
  • Checking: Em andamento.
  • Failed: Falhou.
  • Finished: Concluído.
Percent String 100

Progresso geral da pré-verificação. Unidade: porcentagem.

Detail Array of CheckItem

Resultados da verificação de cada item de pré-verificação.

CheckItem
CheckStatus String Success

Resultado da verificação. Valores válidos:

  • Success: A tarefa passou na verificação.
  • Failed: A tarefa falhou na verificação.
ErrorMessage String Original error: Access denied for user 'dtstest'@'100.104.***.**' (using password: YES)

Mensagem de erro retornada se a tarefa falhar na pré-verificação.

Nota Este parâmetro é retornado apenas se o valor do parâmetro CheckStatus for Failed.
ItemName String CHECK_CONN_SRC

Item de pré-verificação.

RepairMethod String CHECK_ERROR_DEST_CONN_REPAIR2

Método para corrigir a falha na pré-verificação.

Nota Este parâmetro é retornado apenas se o valor do parâmetro CheckStatus for Failed.
SourceEndpoint Object

Configurações de conexão da instância de origem.

DatabaseName String dtstestdatabase

Nome do banco de dados ao qual o objeto de migração pertence na instância de origem.

InstanceId String rm-bp1i99e8l7913****

ID da instância de origem.

IP String 172.16.88.***

Endpoint da instância de origem.

InstanceType String RDS

Tipo da instância de origem. Valores válidos:

  • RDS: Instância ApsaraDB RDS.
  • ECS: Banco de dados autogerenciado hospedado em uma instância ECS.
  • LocalInstance: Banco de dados autogerenciado com endereço IP público.
  • Express: Banco de dados autogerenciado conectado via linha dedicada, VPN Gateway ou Smart Access Gateway.
  • MongoDB: Instância ApsaraDB for MongoDB.
  • POLARDB: Cluster PolarDB for MySQL. Este valor está disponível apenas no site da Alibaba Cloud China (www.aliyun.com).
Port String 3306

Porta de serviço do banco de dados da instância de origem.

UserName String dtstest

Conta do banco de dados da instância de origem.

oracleSID String testsid

SID do banco de dados Oracle.

Nota Este parâmetro é retornado apenas quando o tipo de banco de dados da instância de origem é Oracle.
EngineName String MySQL

Tipo de banco de dados da instância de origem.

StructureInitializationStatus Object

Status da migração de esquema.

Status String Finished

Status da migração de esquema. Valores válidos:

  • NotStarted: Não iniciado.
  • Migrating: Em andamento.
  • Failed: Falhou.
  • Finished: Concluído.
Percent String 100

Progresso da migração de esquema. Unidade: porcentagem.

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

Mensagem de erro retornada se a migração de esquema falhar.

Progress String 1

Número de tabelas com esquemas migrados.

Exemplos

Exemplos de solicitações

Exemplos de respostas de sucesso

Formato JSON

HTTP/1.1 200 OK

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

Throttling.User

Request was denied due to user flow control.

Solicitação negada devido ao controle de fluxo no nível do usuário. Tente novamente mais tarde.

403

InvalidSecurityToken.Expired

Specified SecurityToken is expired.

O token de segurança especificado expirou. Atualize a assinatura.

500

ServiceUnavailable

The request has failed due to a temporary failure of the server.

A solicitação falhou porque o servidor atingiu o tempo limite ou estava indisponível. Repita a solicitação. Se o problema persistir, entre em contato com o suporte técnico.

Para mais códigos de erro, consulte o Centro de Erros.