Configures a distributed transaction whitelist for an RDS instance.

The distributed transaction whitelist allows for distributed transactions between the RDS and ECS instances.

This API action is applicable only to the following DB engine versions and editions:

  • SQL Server 2012/2016 Enterprise High-availability Edition
  • SQL Server 2012/2016 Standard Edition


Use OpenAPI Explorer to perform debug operations and generate SDK code examples.

Request parameters

ID Type Required Example value Description
Action String Yes ModifyDTCSecurityIpHostsForSQLServer The ID of this API action. Value: ModifyDTCSecurityIpHostsForSQLServer.
DBInstanceId String Yes rm-uf6wjk5xxxxxxx

The ID of the specified RDS instance.

RegionId String Yes cn-hangzhou The ID of the region to which the specified RDS instance belongs. You can call the DescribeRegions API action to obtain this region ID.
SecurityIpHosts String Yes,k3ecstest

The IP address of the ECS instance connected to the specified RDS instance, and the device name of the Windows-based system where the ECS instance is located. Format: ip,hostname. If the RDS instance is connected to more than one ECS instance, separate their information by using semicolons (;).

WhiteListGroupName String Yes test1

The name of the whitelist group.

AccessKeyId String No LTAIfCxxxxxxxxxx

The AccessKey ID that Alibaba Cloud issues to a user for service access.

Response elements

ID Type Example value Description
DBInstanceId String rm-uf6wjk5xxxxxxx

The ID of the specified RDS instance.

DTCSetResult String Success

Whether configuring the whitelist succeeded or failed. Valid values:

  • Success
  • Fail
RequestId String 671B6D32-B907-4EFF-A3B7-94D2EAD5E3A3

The ID of the request.

TaskId String 178968983

The ID of the task for configuring the whitelist.


Request example:

http(s):// Action=ModifyDTCSecurityIpHostsForSQLServer
&<Common request parameters>

Response example:

XML format:


JSON format:



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