Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Domain Name Service/ Referência de API/ APIs/ Gerenciamento de servidores de nomes/ Consulta de servidores de nomes

Atualizado em 2023-04-24 GMT+08:00

Ver PDF

Consulta de servidores de nomes

Função

Depuração

Você pode depurar esta API por meio da autenticação automática no API Explorer ou usar o código de exemplo do SDK gerado pelo API Explorer.

URI

GET /v2/nameservers

**Tabela 1** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
type	Não	String	Tipo do servidor de nomes. Opções de valor: public indica um servidor de nomes público. private indica um servidor de nomes privado. A correspondência exata funcionará. É deixado em branco por padrão.
region	Não	String	ID da região. Ao consultar um servidor de nomes público, deixe este parâmetro em branco. A correspondência exata funcionará. É deixado em branco por padrão.

Parâmetros de solicitação

**Tabela 2** Parâmetros do cabeçalho de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-Token	Sim	String	Token do usuário. Ele pode ser obtido pela chamada de uma API do IAM. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário.

Parâmetros de resposta

Código de status: 200

**Tabela 3** Parâmetros de corpo de resposta
Parâmetro	Tipo	Descrição
nameservers	Array of NameServersResp objects	Lista de servidores de nomes

**Tabela 4** NameServersResp
Parâmetro	Tipo	Descrição
type	String	Tipo do servidor de nomes. Opções de valor: - public indica um servidor de nomes público.- private indica um servidor de nomes privado.
region	String	ID da região. Ao consultar um servidor de nomes público, deixe este parâmetro em branco.
ns_records	Array of ns_records objects	Lista de servidores de nomes

**Tabela 5** ns_records
Parâmetro	Tipo	Descrição
hostname	String	Nome do host. Este parâmetro é deixado em branco quando um servidor de nomes privado é usado.
address	String	Endereço do servidor de nomes. Quando o servidor é um servidor de nomes público, esse parâmetro é deixado em branco.
priority	Integer	Prioridade. Se o valor de priority for 1, o servidor do DNS é o primeiro a resolver nomes de domínio.

Exemplo de solicitações

Nenhum

Exemplo de respostas

Código de status: 200

Resposta à solicitação de consulta da lista de servidores de nomes

{
  "nameservers" : [ {
    "region" : null,
    "type" : "public",
    "ns_records" : [ {
      "hostname" : "ns1.huawei.com.",
      "priority" : 1
    }, {
      "hostname" : "ns2.huawei.com.",
      "priority" : 2
    } ]
  }, {
    "region" : "xxx",
    "type" : "private",
    "ns_records" : [ {
      "priority" : 1,
      "address" : "100.125.1.0"
    }, {
      "priority" : 2,
      "address" : "100.125.1.1"
    } ]
  } ]
}