Todos los productos
Search
Centro de documentos

Domain Names:QueryDnsHost

Última actualización: Sep 03, 2026

Esta operación permite consultar el host DNS de un nombre de dominio.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda ejecutar esta operación en OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

ParámetroTipoObligatorioEjemploDescripción
ActionStringSíQueryDnsHost

La operación que desea ejecutar. Establezca el valor en QueryDnsHost.

InstanceIdStringSíST2017120814571100001303

ID de instancia del nombre de dominio cuyo host DNS desea consultar. Puede llamar a la operación QueryDomainList para obtener este ID.

LangStringNoen

Idioma del mensaje de error por devolver. Valores válidos:

  • zh: chino
  • en: inglés

Valor predeterminado:en

UserClientIpStringNo127.0.0.1

Dirección IP del cliente que usa el usuario para iniciar la consulta.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

DnsHostList

Array

Información del host DNS devuelta.

DnsName

String

ns3

Nombre del servidor DNS correspondiente al host DNS consultado.

IpList

List

185.27.XX.XX, 218.83.XX.XX

Lista de direcciones IP.

RequestId

String

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

ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

XML formato

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

JSON formato

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

Códigos de error

Para consultar la lista de códigos de error, visite el Centro de errores de API.