Todos os produtos
Search
Central de documentação

Domain Names:QueryDnsHost

Última atualização: Jun 27, 2026

Chame esta operação para consultar o host DNS de um nome de domínio.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimQueryDnsHost

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

InstanceIdStringSimST2017120814571100001303

ID da instância do nome de domínio cujo host DNS será consultado. Chame a operação QueryDomainList para obter esse ID.

LangStringNãoen

Idioma da mensagem de erro retornada. Valores válidos:

  • zh: Chinês
  • en: Inglês

Valor padrão:en

UserClientIpStringNão127.0.0.1

Endereço IP do cliente usado para iniciar a consulta.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

DnsHostList

Array

Informações do host DNS retornadas.

DnsName

String

ns3

Nome do servidor DNS correspondente ao host DNS consultado.

IpList

List

185.27.XX.XX, 218.83.XX.XX

Lista de endereços IP.

RequestId

String

18A313DD-3AF3-40AA-84F9-56BA45DC511F

ID da solicitação.

Exemplos

Exemplos de solicitações


http(s)://[Endpoint]/? Action=QueryDnsHost
&InstanceId=ST2017120814571100001303
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<QueryDnsHostResponse>
      <DnsHostList>
            <DnsHost>
                  <DnsName>ns3</DnsName>
                  <IpList>
                        <ip>185.27.XX.XX</ip>
                        <ip>218.83.XX.XX</ip>
                  </IpList>
            </DnsHost>
      </DnsHostList>
      <RequestId>18A313DD-3AF3-40AA-84F9-56BA45DC511F</RequestId>
</QueryDnsHostResponse>

Formato JSON

{
	"requestId":"6A973B69-7B5F-4959-AA89-ED4010541D20",
	"dnsHostList":[
		{
			"ipList":[
				"185.27.XX.XX",
				"218.83.XX.XX"
			],
			"dnsName":"ns3"
		}
	]
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.