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

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

使用该接口需注意:

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

调试

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

请求参数

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

系统规定参数,取值:UpgradeTwoWay

InstanceClass String large

双向同步的实例规格,取值为largemediummicrosmall

说明 链路规格说明,请参见数据同步链路规格说明
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
}

错误码

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