StartDtsJob - Data Transmission Service - Centro de documentación de Alibaba Cloud

Inicia una tarea de migración de datos, sincronización de datos o seguimiento de cambios.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	StartDtsJob	La operación que desea ejecutar. Establezca el valor en StartDtsJob.
DtsJobId	String	Sí	l3m1213ye7l****	El ID de la tarea de migración de datos, sincronización de datos o seguimiento de cambios.
DtsInstanceId	String	No	dtsl3m1213ye7l****	El ID de la instancia de migración de datos, sincronización de datos o seguimiento de cambios. Nota Llame a la operación DescribeMigrationJobs, DescribeSubscriptionInstances o DescribeSynchronizationJobs para consultar el ID de la instancia.
SynchronizationDirection	String	No	Forward	La dirección de sincronización. Valor predeterminado: Forward. Valores válidos: Forward: Los datos se sincronizan desde la base de datos de origen hacia la base de datos de destino. Reverse: Los datos se sincronizan desde la base de datos de destino hacia la base de datos de origen. Nota Establezca este parámetro en Reverse para iniciar la tarea de sincronización inversa solo si la topología es de sincronización bidireccional.
RegionId	String	No	cn-hangzhou	El ID de región de la instancia de Data Transmission Service (DTS). Para obtener más información, consulte Lista de regiones compatibles.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
HttpStatusCode	Integer	200	El código de estado HTTP.
RequestId	String	601B6F25-21E7-4484-99D5-3EF2625C****	El ID de la solicitud.
ErrCode	String	InternalError	El código de error devuelto si la solicitud se completó con errores.
Success	Boolean	true	Indica si la solicitud se completó correctamente.
ErrMessage	String	The Value of Input Parameter %s is not valid.	El mensaje de error devuelto si la solicitud se completó con errores.
DynamicMessage	String	DtsJobId	La parte dinámica del mensaje de error. Este parámetro reemplaza la variable %s en el parámetro ErrMessage. Nota Por ejemplo, si el valor devuelto del parámetro ErrMessage es The Value of Input Parameter %s is not valid y el valor devuelto del parámetro DynamicMessage es DtsJobId, significa que el parámetro DtsJobId especificado no es válido.
DynamicCode	String	403	El código de error dinámico. Este parámetro se eliminará en el futuro.

Ejemplos

Solicitudes de ejemplo

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

Respuestas correctas de ejemplo

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
403	OperationDenied.NotPurchased	The instance has not been purchased and the task cannot be started.	Mensaje de error devuelto porque la instancia no se ha adquirido y la tarea no puede iniciarse. Adquiera una instancia primero.
403	InvalidSecurityToken.Expired	Specified SecurityToken is expired.	Mensaje de error devuelto porque la firma caducó. Utilice una nueva firma.
400	Throttling.User	Request was denied due to user flow control.	Mensaje de error devuelto porque el número de solicitudes excede el límite y la solicitud se rechaza. Inténtelo de nuevo más tarde.
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.	Mensaje de error devuelto porque la respuesta del servidor agotó el tiempo de espera o el servidor no estaba available. Inténtelo de nuevo. Si el error persiste, póngase en contacto con el soporte técnico.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.