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

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

仅适用于如下版本实例：

  • SQL Server 2012/2016企业版高可用版
  • SQL Server 2012/2016标准版

调试

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

请求参数

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

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

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

实例ID。
RegionId String 是 cn-hangzhou

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

AccessKeyId String 否 LTAIfCxxxxxxxxxx

阿里云颁发给用户的访问服务所用的密钥ID。

返回数据

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

实例ID。
IpHostPairNum String 1

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

分布式事务白名单分组列表。
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 格式 

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

错误码

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