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.

Nesta página

Função
Depuração
URI
Parâmetros de solicitação
Parâmetros de resposta
Exemplo de solicitações
Exemplo de respostas
Códigos de status
Códigos de erro

Mostrar todos

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

Consulta de servidores de nomes

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

Ver PDF

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

Códigos de status

Código de status	Descrição
200	Resposta à solicitação de consulta da lista de servidores de nomes

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Gerenciamento de servidores de nomes

Tópico anterior: Gerenciamento de servidores de nomes

Próximo tópico: Exemplos

Feedback

Esta página foi útil?

Sim Não

Deixar um comentário

Obrigado por seus comentários. Estamos trabalhando para melhorar a documentação.

O sistema está ocupado. Tente novamente mais tarde.

Quais dos seguintes problemas você encontrou?

O conteúdo é inconsistente com a UI do produto

Descrições pouco claras

Falta de exemplos ou código

Passos incorretos

Não encontro o que preciso

Falta de melhores práticas

Feedback (opcional)

0/500

Selecione pelo menos um tipo de problema e insira seus comentários ou sugestões.

Insira um máximo de 500 caracteres.

Enviar Cancelar