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 zonas públicas/ Consulta de servidores de nomes em uma zona pública

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

Ver PDF

Consulta de servidores de nomes em uma zona pública

Função

Esta API é usada para consultar os servidores de nomes em uma zona pública.

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/zones/{zone_id}/nameservers

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
zone_id	Sim	String	ID da zona. Você pode obter o valor consultando a lista de zonas públicas. Mínimo: 32 Máximo: 36

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 nameserver objects	Resposta à solicitação de consulta dos servidores de nomes em uma zona pública

**Tabela 4** nameserver
Parâmetro	Tipo	Descrição
hostname	String	Nome do host
priority	Integer	Prioridade

Código de status: 400

**Tabela 5** Parâmetros de corpo de resposta
Parâmetro	Tipo	Descrição
code	String	Código de erro Mínimo: 8 Máximo: 36
message	String	Descrição Mínimo: 2 Máximo: 512

Código de status: 404

**Tabela 6** Parâmetros de corpo de resposta
Parâmetro	Tipo	Descrição
code	String	Código de erro Mínimo: 8 Máximo: 36
message	String	Descrição Mínimo: 2 Máximo: 512

Código de status: 500

**Tabela 7** Parâmetros de corpo de resposta
Parâmetro	Tipo	Descrição
code	String	Código de erro Mínimo: 8 Máximo: 36
message	String	Descrição Mínimo: 2 Máximo: 512

Exemplos de solicitações

Nenhum

Exemplo de respostas

Código de status: 200

Resposta à solicitação de consulta dos servidores de nomes em uma zona pública

{
  "nameservers" : [ {
    "hostname" : "ns1.example.com.",
    "priority" : 1
  }, {
    "hostname" : "ns2.example.com.",
    "priority" : 2
  } ]
}