DescribeDTCSecurityIpHostsForSQLServer操作を呼び出して、ApsaraDB RDSインスタンスの分散トランザクションホワイトリストを照会できます。

詳細については、「分散トランザクションのホワイトリストの設定」をご参照ください。

この操作は、RDS High-Availability Editionで次のSQL Serverバージョンのいずれかを実行するインスタンスに適用できます。SQL Server 2012 SE、SQL Server 2012 EE、SQL Server 2014 SE、SQL Server 2016 SE、SQL Server 2016 EE、およびSQL Server 2017 SE。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 DescribeDTCSecurityIpHostsForSQLServer

実行する操作です。 値をDescribeDTCSecurityIpHostsForSQLServerに設定します。

DBInstanceId String 必須 rm-uf6wjk5xxxxxxx

インスタンスの ID です。

RegionId String 必須 cn-hangzhou

インスタンスが存在するリージョンのID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

ResourceGroupId String 任意 rg-acfmy *****

リソースグループの ID です。

レスポンスパラメーター

項目 データ型 例: 説明　
DBInstanceId String rm-uf6wjk5xxxxxxx

インスタンスの ID です。

RequestId String 2CA62A70-2203-45C6-8E90-8971D5ACC0C2

リクエストの ID です。

IpHostPairNum String 1

分散トランザクションのホワイトリストの数。

項目 WhiteListGroupsの配列

分散トランザクションのホワイトリストの詳細。

WhiteListGroups
SecurityIpHosts String 192.168.1.100、k3ecstest

ECSインスタンスのIPアドレスとWindowsコンピューターのホスト名。 形式: IPアドレス、ホスト名。 複数の値はセミコロン (;) で区切ります。

WhitelistGroupName String test1

分散トランザクションのホワイトリストの名前。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=DescribeDTCSecurityIpHostsForSQLServer
&DBInstanceId=rm-uf6wjk5xxxxxxx
&RegionId=cn-hangzhou
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDTCSecurityIpHostsForSQLServerResponse>
<アイテム>
<WhiteListGroups>
<WhitelistGroupName>test1</WhitelistGroupName>
<SecurityIpHosts>192.168.1.100、k3ecstest</SecurityIpHosts>
</WhiteListGroups>
</アイテム>
<IpHostPairNum>1</IpHostPairNum>
<RequestId>2CA62A70-2203-45C6-8E90-8971D5ACC0C2</RequestId>
</DescribeDTCSecurityIpHostsForSQLServerResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

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

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。