Todos os produtos
Search
Central de documentação

Data Transmission Service:StartDtsJob

Última atualização: Jun 27, 2026

Inicia uma tarefa de migração de dados, sincronização de dados ou rastreamento de alterações.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim StartDtsJob

Operação a ser executada. Defina o valor como StartDtsJob.

DtsJobId String Sim l3m1213ye7l****

ID da tarefa de migração de dados, sincronização de dados ou rastreamento de alterações.

DtsInstanceId String Não dtsl3m1213ye7l****

ID da instância de migração de dados, sincronização de dados ou rastreamento de alterações.

Nota Chame a operação DescribeMigrationJobs, DescribeSubscriptionInstances ou DescribeSynchronizationJobs para consultar o ID da instância.
SynchronizationDirection String Não Forward

Direção da sincronização. Valor padrão: Forward. Valores válidos:

  • Forward: sincroniza os dados do banco de dados de source para o banco de dados de destino.
  • Reverse: sincroniza os dados do banco de dados de destino para o banco de dados de source.
    Nota Defina este parâmetro como Reverse para iniciar a tarefa de sincronização reversa apenas se a topologia for de sincronização bidirecional.
RegionId String Não cn-hangzhou

ID da região da instância do Data Transmission Service (DTS). Para obter mais informações, consulte Lista de regiões suportadas.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
HttpStatusCode Integer 200

Código de status HTTP.

RequestId String 601B6F25-21E7-4484-99D5-3EF2625C****

ID da solicitação.

ErrCode String InternalError

Código de erro retornado em caso de falha na solicitação.

Success Boolean true

Indica se a solicitação foi bem-sucedida.

ErrMessage String The Value of Input Parameter %s is not valid.

Mensagem de erro retornada em caso de falha na solicitação.

DynamicMessage String DtsJobId

Parte dinâmica da mensagem de erro. Este parâmetro substitui a variável %s no parâmetro ErrMessage.

Nota Por exemplo, se o valor retornado do parâmetro ErrMessage for The Value of Input Parameter %s is not valid e o valor retornado do parâmetro DynamicMessage for DtsJobId, o parâmetro DtsJobId especificado é inválido.
DynamicCode String 403

Código de erro dinâmico. Este parâmetro será removido futuramente.

Exemplos

Exemplos de solicitações

http(s)://dts.aliyuncs.com/?Action=StartDtsJob
&DtsJobId=l3m1213ye7l****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<StartDtsJobResponse>
    <RequestId>2D3B4615-923F-49AA-AF21-6D8E3967****</RequestId>
    <HttpStatusCode>200</HttpStatusCode>
    <Success>true</Success>
</StartDtsJobResponse>

Formato JSON

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

{
  "RequestId" : "2D3B4615-923F-49AA-AF21-6D8E3967****",
  "HttpStatusCode" : 200,
  "Success" : true
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

403

OperationDenied.NotPurchased

The instance has not been purchased and the task cannot be started.

Mensagem de erro retornada porque a instância não foi adquirida e a tarefa não pode ser iniciada. Adquira uma instância primeiro.

403

InvalidSecurityToken.Expired

Specified SecurityToken is expired.

Mensagem de erro retornada porque a assinatura expirou. Utilize uma nova assinatura.

400

Throttling.User

Request was denied due to user flow control.

Mensagem de erro retornada porque o número de solicitações excedeu o limite e a solicitação foi rejeitada. Tente novamente mais tarde.

500

ServiceUnavailable

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

Mensagem de erro retornada porque a resposta do servidor atingiu o tempo limite ou o servidor estava indisponível. Tente novamente. Se o erro persistir, entre em contato com o suporte técnico.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.