调用DescribeDTCSecurityIpHostsForSQLServer接口查询RDS实例的分布式事务白名单信息。

关于分布式事务白名单请参见设置分布式事务白名单。

仅适用于RDS SQL Server高可用系列（2012标准版、2012企业版、2014标准版、2016标准版、2016企业版、2017标准版）。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeDTCSecurityIpHostsForSQLServer

系统规定参数，取值：DescribeDTCSecurityIpHostsForSQLServer。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

实例ID。
RegionId String 是 cn-hangzhou

地域ID，可以通过接口DescribeRegions查看。

返回数据

名称 类型 示例值 描述
DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。
IpHostPairNum String 1

分布式事务白名单条目数。
Items Array

分布式事务白名单分组列表。
WhiteListGroups
SecurityIpHosts String 192.168.1.100,k3ecstest

ECS实例的IP地址和Windows系统的计算机名。格式：ip,hostname。多个实例之间以英文分号（;）隔开。
WhitelistGroupName String test1

分布式事务白名单分组名称。
RequestId String 2CA62A70-2203-45C6-8E90-8971D5ACC0C2

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeDTCSecurityIpHostsForSQLServer
&DBInstanceId=rm-uf6wjk5xxxxxxx
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeDTCSecurityIpHostsForSQLServerResponse>
  <Items>
		    <WhiteListGroups>
			      <WhitelistGroupName>test1</WhitelistGroupName>
			      <SecurityIpHosts>192.168.1.100,k3ecstest</SecurityIpHosts>
		    </WhiteListGroups>
	  </Items>
	  <IpHostPairNum>1</IpHostPairNum>
	  <RequestId>2CA62A70-2203-45C6-8E90-8971D5ACC0C2</RequestId>
</DescribeDTCSecurityIpHostsForSQLServerResponse>

JSON 格式 

{
	"Items": {
		"WhiteListGroups": [
			{
				"WhitelistGroupName": "test1",
				"SecurityIpHosts": "192.168.1.100,k3ecstest"
			}
		]
	},
	"IpHostPairNum": 1,
	"RequestId": "2CA62A70-2203-45C6-8E90-8971D5ACC0C2"
}

错误码

访问错误中心查看更多错误码。