调用UpgradeTwoWay接口将DTS同步实例的同步拓扑从单向同步升级为双向同步，目前只支持后付费任务的升级。

请确保在使用该接口前，已充分了解云数据库DTS产品的收费方式和价格。

使用该接口需注意：

  • 数据同步任务的源实例和目标实例的数据库类型均为MySQL。
  • 数据同步任务的同步拓扑为单向同步。
  • 数据同步任务的状态为同步中。
  • 升级生效期间数据同步会出现5秒左右的延迟，请在业务低峰期操作。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 UpgradeTwoWay

系统规定参数，取值：UpgradeTwoWay。

InstanceClass String 是 large

双向同步的实例规格，取值为large、medium、micro 、small。

说明 链路规格说明，请参见数据同步链路规格说明。
InstanceId String 是 dtsh77p49x4k28****

实例ID，可通过调用DescribeDtsJobs获取。

RegionId String 否 cn-hangzhou

DTS实例所属的地域，详情请参见支持的地域列表。

返回数据

名称 类型 示例值 描述
DynamicCode String 403

动态错误码，本参数即将下线。
DynamicMessage String InstanceId

动态错误信息，用于替换返回参数ErrMessage错误信息中的%s。

说明 如果ErrMessage返回The Value of Input Parameter %s is not valid，且DynamicMessage返回InstanceId，则代表所传入的请求参数InstanceId不合法。
ErrCode String InternalError

调用错误时返回的错误码。
ErrMessage String The Value of Input Parameter %s is not valid.

调用错误时返回的错误信息。
HttpStatusCode Integer 200

状态码。
RequestId String 2D3B4615-923F-49AA-AF21-6D8E3967****

请求ID。
Success Boolean true

请求是否成功，返回值：

  • true：请求成功。
  • false：请求失败。

示例

请求示例

http(s)://dts.aliyuncs.com/?Action=UpgradeTwoWay
&InstanceClass=large
&InstanceId=dtsh77p49x4k28****
&<公共请求参数>

正常返回示例

XML格式 

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

JSON格式 

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

错误码

访问错误中心查看更多错误码。