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 2025-08-19 GMT+08:00
Ver PDF
Compartilhar

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 Chamada das API 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
  } ]
}

Códigos de status

Código de status

Descrição

200

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

400

Resposta de erro

404

Resposta de erro

500

Resposta de erro

Códigos de erro

Consulte Códigos de erro.