Todos os produtos
Search
Central de documentação

:Consultar listas de permissões de transações distribuídas

Última atualização: Jun 26, 2026

Chame a operação DescribeDTCSecurityIpHostsForSQLServer para consultar as listas de permissões de transações distribuídas de uma instância do ApsaraDB RDS.

Para obter mais informações, consulte Configure uma lista de permissões de transação distribuída.

Esta operação aplica-se a instâncias que executam uma das seguintes versões do SQL Server no RDS High-Availability Edition: SQL Server 2012 SE, SQL Server 2012 EE, SQL Server 2014 SE, SQL Server 2016 SE, SQL Server 2016 EE e SQL Server 2017 SE.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DescribeDTCSecurityIpHostsForSQLServer

Operação a ser executada. Defina o valor como DescribeDTCSecurityIpHostsForSQLServer.

DBInstanceId

String

Sim

rm-uf6wjk5xxxxxxx

ID da instância.

RegionId

String

Sim

cn-hangzhou

ID da região onde as instâncias estão localizadas. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

ResourceGroupId

String

Não

rg-acfmy*

ID do grupo de recursos.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

DBInstanceId

String

rm-uf6wjk5xxxxxxx

ID da instância.

RequestId

String

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

ID da solicitação.

IpHostPairNum

String

1

Quantidade de listas de permissões de transações distribuídas.

Items

Array of WhiteListGroups

Detalhes das listas de permissões de transações distribuídas.

WhiteListGroups

SecurityIpHosts

String

192.168.1.100,k3ecstest

Endereço IP da instância ECS e nome do host do computador Windows. Formato: Endereço IP,Nome do host. Separe vários valores com ponto e vírgula (;).

WhitelistGroupName

String

test1

Nome da lista de permissões de transação distribuída.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato 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>

Formato 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"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.