Modifies the objects for change tracking.
When you call this operation, the change tracking task must be in the Normal, NotStarted, or Failed state.
- 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
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.