Modifies the objects for change tracking.

When you call this operation, the change tracking task must be in the Normal, NotStarted, or Failed state.

Note
  • If you call this operation to modify the objects of a change tracking task that is in the Normal state, DTS automatically calls the StartSubscriptionInstance to restart the task.
  • If you call this operation to modify the objects of a change tracking task that is in the NotStarted or Failed state, DTS does not automatically start the task. You must call the StartSubscriptionInstance to restart the task.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer automatically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifySubscriptionObject

The operation that you want to perform. Set the value to ModifySubscriptionObject.

SubscriptionInstanceId String Yes dtsl8zl9ek6292****

The ID of the change tracking instance. You can call the DescribeSubscriptionInstances operation to query the instance ID.

SubscriptionObject String Yes [{"DBName":"dtstestdata"}]

The objects from which you want to track data changes. The value is a JSON string and can contain regular expressions. For more information, see SubscriptionObjects.

RegionId String No cn-hangzhou

The ID of the region where the change tracking instance resides. For more information, see List of supported regions.

AccountId String No 12323344****

The ID of the Alibaba Cloud account. You do not need to specify this parameter because this parameter will be removed in the future.

Response parameters

Parameter Type Example Description
ErrCode String InternalError

The error code returned if the call failed.

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

The error message returned if the call failed.

RequestId String ABBACEFC-CBA9-4F80-A337-42F202F5****

The ID of the request.

Success String true

Indicates whether the call was successful.

Examples

Sample requests

http(s)://dts.aliyuncs.com/?Action=ModifySubscriptionObject
&SubscriptionInstanceId=dtsl8zl9ek6292****
&SubscriptionObject=[{"DBName":"dtstestdata"}]
&<Common request parameters>

Sample success responses

XML format

<ModifySubscriptionObjectResponse>
      <RequestId>ABBACEFC-CBA9-4F80-A337-42F202F5****</RequestId>
      <Success>true</Success>
</ModifySubscriptionObjectResponse>

JSON format

{
	"RequestId": "ABBACEFC-CBA9-4F80-A337-42F202F5****",
	"Success": true
}

Error codes

For a list of error codes, visit the API Error Center.