调用ModifySynchronizationObject接口修改数据同步实例中的同步对象。

说明 调用本接口时,数据同步实例需处于未启动或同步中状态。

调试

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

请求参数

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

系统规定参数,取值:ModifySynchronizationObject

SynchronizationJobId String dtskfq1149w254****

数据同步实例ID,可以通过调用DescribeSynchronizationJobs接口查询。

SynchronizationObjects String [{"DBName": "dtstestdata"}]

修改后的同步对象,格式为JSON串且支持一定的正则表达式,详细说明请参见同步对象配置说明

RegionId String cn-hangzhou

地域ID,传入本参数来指定实例所在地域,详情请参见支持的地域列表

SynchronizationDirection String Forward

指定同步方向,取值:

  • Forward:正向。
  • Reverse:反向。
说明
  • 默认取值为Forward
  • 只有当数据同步实例的同步拓扑为双向同步时,才需要传入本参数。
AccountId String 12323344****

阿里云主账号ID,无需设置,该参数即将下线。

返回数据

名称 类型 示例值 描述
ErrCode String InternalError

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

ErrMessage String The request processing has failed due to some unknown error.

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

RequestId String 902DDCDE-C755-4458-85DA-DF9A323C****

请求ID。

Success String true

请求是否成功。

TaskId String tl911uvi25z****

任务ID,您可以根据此参数调用DescribeSynchronizationObjectModifyStatus接口查询同步对象变更的状态及进度。

示例

请求示例

http(s)://dts.aliyuncs.com/?Action=ModifySynchronizationObject
&SynchronizationJobId=dtskfq1149w254****
&SynchronizationObjects=[{"DBName": "dtstestdata"}]
&<公共请求参数>

正常返回示例

XML格式

<ModifySynchronizationObjectResponse>
      <TaskId>tl911uvi25z****</TaskId>
      <RequestId>902DDCDE-C755-4458-85DA-DF9A323C****</RequestId>
      <Success>true</Success>
</ModifySynchronizationObjectResponse>

JSON格式

{
	"TaskId": "tl911uvi25z****",
	"RequestId": "902DDCDE-C755-4458-85DA-DF9A323C****",
	"Success": true
}

错误码

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