调用ReverseTwoWayDirection接口,调转双向同步任务的方向。

DTS双向同步任务中的反向任务会自动过滤DDL,当业务场景要求主备数据库切换或者双云切换时,需要调转双向同步任务的方向。

使用该接口需注意:

  • 操作前请仔细阅读双向同步文档,以MySQL为例,请参见MySQL实例间的双向同步
  • 修改同步对象时不允许调转同步任务。
  • 分布式同步任务不支持调转任务方向。

调试

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

请求参数

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

系统规定参数。取值:ReverseTwoWayDirection

RegionId String cn-hangzhou

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

DtsInstanceId String dtsldy114cy24f****

双向同步任务的实例ID。

IgnoreErrorSubJob Boolean false

是否忽略异常的同步子任务,默认不忽略,该参数暂时不开放。

返回数据

名称 类型 示例值 描述
HttpStatusCode Integer 200

状态码。

RequestId String AD823BD3-1BA6-4117-A536-165CB280****

请求ID。

ErrCode String 403

调用错误时返回的错误码。

Success Boolean true

请求是否成功,返回值:

  • true:请求成功。
  • false:请求失败。
ErrMessage String The Value of Input Parameter %s is not valid.

调用错误时返回的错误信息。

Code String 200

错误码,本参数即将下线。

DynamicMessage String DtsInstanceId

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

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

示例

请求示例

http(s)://dts.aliyuncs.com/?Action=ReverseTwoWayDirection
&RegionId=cn-hangzhou
&DtsInstanceId=dtsldy114cy24f****
&公共请求参数

正常返回示例

XML格式

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

<ReverseTwoWayDirectionResponse>
    <RequestId>AD823BD3-1BA6-4117-A536-165CB280****</RequestId>
    <HttpStatusCode>200</HttpStatusCode>
    <Success>true</Success>
</ReverseTwoWayDirectionResponse>

JSON格式

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

{
  "RequestId" : "AD823BD3-1BA6-4117-A536-165CB280****",
  "HttpStatusCode" : 200,
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
400 Throttling.User Request was denied due to user flow control. 由于请求频次达到阈值,请求被拒绝,请稍后重试。
500 ServiceUnavailable The request has failed due to a temporary failure of the server. 由于服务端响应超时或者不可用导致请求失败,请重试,重试后仍失败请联系技术支持。
403 InvalidSecurityToken.Expired Specified SecurityToken is expired. 签名已经过期,请更新签名

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