Todos os produtos
Search
Central de documentação

:Consultar o hostname de uma instância ApsaraDB for RDS

Última atualização: Jun 26, 2026

Consulta o hostname de uma instância ApsaraDB for RDS.

As instâncias RDS são implantadas com base em instâncias ECS. Esta operação permite consultar o hostname de uma instância RDS. O hostname é necessário quando você configure uma lista de permissões de transações distribuídas.

A instância RDS deve estar na edição High-availability e executar uma das seguintes edições do SQL Server: 2012 SE, 2012 EE, 2014 SE, 2016 SE, 2016 EE e 2017 SE.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar o uso, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de requisição

Parameter

Type

Required

Example

Description

Action

String

Yes

DescribeDBInstanceIpHostname

A operação que você deseja executar. Defina o valor como DescribeDBInstanceIpHostname.

DBInstanceId

String

Yes

rm-uf6wjk5xxxxxxx

O ID da instância RDS.

RegionId

String

Yes

cn-hangzhou

O ID da região da instância RDS. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

Parâmetros de resposta

Parameter

Type

Example

Description

DBInstanceId

String

rm-uf6wjk5xxxxxxx

O ID da instância RDS.

IpHostnameInfos

String

172.16.xx.xx,sdxxxxxxxxB;172.16.xx.xx,sdxxxxxxxxA

Os endereços IP privados e os hostnames das instâncias RDS primária e em standby. Formato: Endereço IP 1,Hostname 1;Endereço IP 2,Hostname 2.

RequestId

String

67CD4719-51E3-4A76-A38C-02F45FAE7E36

O ID da requisição.

Exemplos

Exemplos de requisição

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

Exemplos de respostas bem-sucedidas

XML format

<DescribeDBInstanceIpHostnameResponse>
  <IpHostnameInfos>172.16.xx.xx,sdxxxxxxxxB;172.16.xx.xxx,sdxxxxxxxxA</IpHostnameInfos>
	  <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
	  <RequestId>67CD4719-51E3-4A76-A38C-02F45FAE7E36</RequestId>
</DescribeDBInstanceIpHostnameResponse>

JSON format

{
	"IpHostnameInfos": "172.16.xx.xx,sdxxxxxxxxB;172.16.xx.xx,sdxxxxxxxxA",
	"DBInstanceId": "rm-uf6wjk5xxxxxxx",
	"RequestId": "67CD4719-51E3-4A76-A38C-02F45FAE7E36"
}

Códigos de erro

Para obter a lista de códigos de erro, acesse o API Error Center.