调用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 | 请求是否成功,返回值:
|
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. | 签名已经过期,请更新签名 |
访问错误中心查看更多错误码。