Upgrades the synchronization topology of a data synchronization instance from one-way synchronization to two-way synchronization. This operation is supported only for pay-as-you-go synchronization instances.

Before you call this operation, make sure that you fully understand the billing methods and pricing of Data Transmission Service (DTS)

When you call this operation, take note of the following information:

  • The source and destination databases of the data synchronization task are both MySQL databases.
  • The synchronization topology of the data synchronization task is one-way synchronization.
  • The data synchronization task is in the Synchronizing state.
  • The upgrade operation causes data synchronization latency of about 5 seconds. We recommend that you perform this operation during off-peak hours.


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 UpgradeTwoWay

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

InstanceClass String Yes large

The instance class of the two-way synchronization task. Valid values: large, medium, micro, and small.

Note For more information, see Specifications of data synchronization instances.
InstanceId String Yes dtsh77p49x4k28****

The ID of the data synchronization instance. You can call the DescribeDtsJobs operation to query the instance ID.

RegionId String No cn-hangzhou

The region ID of the DTS instance. For more information, see List of supported regions.

Response parameters

Parameter Type Example Description
DynamicCode String 403

The dynamic error code. This parameter will be removed in the future.

DynamicMessage String InstanceId

The dynamic part in the error message. This parameter is used to replace the %s variable in the ErrMessage parameter.

Note If the return value of the ErrMessage parameter is The Value of Input Parameter %s is not valid and that of the DynamicMessage parameter is InstanceId, the specified InstanceId parameter is invalid.
ErrCode String InternalError

The error code returned if the call failed.

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

The error message returned if the call failed.

HttpStatusCode Integer 200

The HTTP status code.

RequestId String 2D3B4615-923F-49AA-AF21-6D8E3967****

The ID of the request.

Success Boolean true

Indicates whether the call was successful. Valid values:

  • true: The call was successful.
  • false: The call failed.


Sample requests

&<Common request parameters>

Sample success responses

XML format


JSON format


Error codes

For a list of error codes, visit the API Error Center.