All Products
Search
Document Center

Data Transmission Service:CreateReverseDtsJob

Last Updated:Oct 30, 2023

Creates a reverse task for a data synchronization or migration task.

After a reverse task is created, Data Transmission Service (DTS) performs a precheck. The incremental data collection starts after the task passes the precheck. The Incremental Write module is not started. To start the Incremental Write module, call the StartReverseWriter operation.

Note A reverse task is a data synchronization task that runs only the Incremental Write module.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter

Type

Required

Example

Description

Action String Yes CreateReverseDtsJob

The operation that you want to perform. Set the value to CreateReverseDtsJob.

DtsJobId String Yes n99m9jx822k****

The ID of the data synchronization or migration task. You can call the DescribeDtsJobs operation to query the task ID.

Response parameters

Parameter

Type

Example

Description

HttpStatusCode String 200

The HTTP status code.

RequestId String 621BB4F8-3016-4FAA-8D5A-5D3163CC****

The request ID.

ErrCode String InternalError

The error code returned if the request failed.

DtsJobId String n99m9jx822k****

The ID of the data synchronization task in the reverse direction.

DtsInstanceId String dtsor1f9kr822l****

The ID of the DTS instance in which the data synchronization task in the reverse direction is created.

Success String true

Indicates whether the request was successful.

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

The error message returned if the request failed.

Examples

Sample requests

http(s)://dts.aliyuncs.com/?Action=CreateReverseDtsJob
&DtsJobId=n99m9jx822k****
&Common request parameters

Sample success responses

XML format

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

<CreateReverseDtsJobResponse>
    <HttpStatusCode>200</HttpStatusCode>
    <RequestId>621BB4F8-3016-4FAA-8D5A-5D3163CC****</RequestId>
    <DtsJobId>n99m9jx822k****</DtsJobId>
    <DtsInstanceId>dtsor1f9kr822l****</DtsInstanceId>
    <Success>true</Success>
</CreateReverseDtsJobResponse>

JSON format

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

{
  "HttpStatusCode" : "200",
  "RequestId" : "621BB4F8-3016-4FAA-8D5A-5D3163CC****",
  "DtsJobId" : "n99m9jx822k****",
  "DtsInstanceId" : "dtsor1f9kr822l****",
  "Success" : "true"
}

Error codes

HTTP status code

Error code

Error message

Description

403 InvalidSecurityToken.Expired Specified SecurityToken is expired. The signature expired. Use a new signature.
403 InvalidParameter The value of the parameter %s is invalid. The specified value was invalid. Enter a valid value.
500 ServiceUnavailable The request has failed due to a temporary failure of the server. The response of the server timed out or the server was unavailable. Try again. If the error persists, contact technical support.
400 Throttling.User Request was denied due to user flow control. The number of requests exceeded the limit, and the request was rejected. Try again later.

For a list of error codes, see Service error codes.