調(diào)用ModifySynchronizationObject接口修改數(shù)據(jù)同步實(shí)例中的同步對(duì)象。

說(shuō)明 調(diào)用本接口時(shí)，數(shù)據(jù)同步實(shí)例需處于未啟動(dòng)或同步中狀態(tài)。

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。

請(qǐng)求參數(shù)

名稱(chēng) 類(lèi)型 是否必選 示例值 描述
Action String 是 ModifySynchronizationObject

系統(tǒng)規(guī)定參數(shù)，取值：ModifySynchronizationObject。

SynchronizationJobId String 是 dtskfq1149w254****

數(shù)據(jù)同步實(shí)例ID，可以通過(guò)調(diào)用DescribeSynchronizationJobs接口查詢(xún)。

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

修改后的同步對(duì)象，格式為JSON串且支持一定的正則表達(dá)式，詳細(xì)說(shuō)明請(qǐng)參見(jiàn)同步對(duì)象配置說(shuō)明。

RegionId String 否 cn-hangzhou

地域ID，傳入本參數(shù)來(lái)指定實(shí)例所在地域，詳情請(qǐng)參見(jiàn)支持的地域列表。

SynchronizationDirection String 否 Forward

指定同步方向，取值：

  • Forward：正向。
  • Reverse：反向。
說(shuō)明
  • 默認(rèn)取值為Forward。
  • 只有當(dāng)數(shù)據(jù)同步實(shí)例的同步拓?fù)錇殡p向同步時(shí)，才需要傳入本參數(shù)。
AccountId String 否 12323344****

阿里云主賬號(hào)ID，無(wú)需設(shè)置，該參數(shù)即將下線(xiàn)。

返回?cái)?shù)據(jù)

名稱(chēng) 類(lèi)型 示例值 描述
ErrCode String InternalError

調(diào)用出錯(cuò)時(shí)返回的錯(cuò)誤碼。
ErrMessage String The request processing has failed due to some unknown error.

調(diào)用錯(cuò)誤時(shí)返回對(duì)應(yīng)的錯(cuò)誤信息。
RequestId String 902DDCDE-C755-4458-85DA-DF9A323C****

請(qǐng)求ID。
Success String true

請(qǐng)求是否成功。
TaskId String tl911uvi25z****

任務(wù)ID，您可以根據(jù)此參數(shù)調(diào)用DescribeSynchronizationObjectModifyStatus接口查詢(xún)同步對(duì)象變更的狀態(tài)及進(jìn)度。

示例

請(qǐng)求示例

http(s)://dts.aliyuncs.com/?Action=ModifySynchronizationObject
&SynchronizationJobId=dtskfq1149w254****
&SynchronizationObjects=[{"DBName": "dtstestdata"}]
&<公共請(qǐng)求參數(shù)>

正常返回示例

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
}

錯(cuò)誤碼

訪(fǎng)問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。