Tous les produits
Search
Centre de documentation

:Interroger les listes d'autorisation des transactions distribuées

Dernière mise à jour :Aug 19, 2026

Appelez l'opération DescribeDTCSecurityIpHostsForSQLServer pour interroger les listes d'autorisation des transactions distribuées d'une instance ApsaraDB RDS.

Pour plus d'informations, consultez la rubrique Configurer une liste d'autorisation de transaction distribuée.

Cette opération s'applique aux instances exécutant l'une des versions SQL Server suivantes sur RDS High-Availability Edition : SQL Server 2012 SE, SQL Server 2012 EE, SQL Server 2014 SE, SQL Server 2016 SE, SQL Server 2016 EE et SQL Server 2017 SE.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. Il génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

DescribeDTCSecurityIpHostsForSQLServer

Opération à effectuer. Définissez la valeur sur DescribeDTCSecurityIpHostsForSQLServer.

DBInstanceId

String

Oui

rm-uf6wjk5xxxxxxx

ID de l'instance.

RegionId

String

Oui

cn-hangzhou

ID de la région où se trouvent les instances. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.

ResourceGroupId

String

Non

rg-acfmy*

ID du groupe de ressources.

Paramètres de réponse

Paramètre

Type

Exemple

Description

DBInstanceId

String

rm-uf6wjk5xxxxxxx

ID de l'instance.

RequestId

String

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

ID de la requête.

IpHostPairNum

String

1

Nombre de listes d'autorisation de transactions distribuées.

Items

Tableau de WhiteListGroups

Détails des listes d'autorisation de transactions distribuées.

WhiteListGroups

SecurityIpHosts

String

192.168.1.100,k3ecstest

Adresse IP de l'instance ECS et nom d'hôte de l'ordinateur Windows. Format : adresse IP,nom d'hôte. Séparez les valeurs multiples par des points-virgules (;).

WhitelistGroupName

String

test1

Nom de la liste d'autorisation de transaction distribuée.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=DescribeDTCSecurityIpHostsForSQLServer
&DBInstanceId=rm-uf6wjk5xxxxxxx
&RegionId=cn-hangzhou
&<Common request parameters>

Exemple de réponse réussie

Format XML

HTTP/1.1 200 OK
Content-Type:application/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>

Format JSON

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

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs de l'API.