调用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 |
指定同步方向,取值:
说明
|
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
}
错误码
访问错误中心查看更多错误码。