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 privadas/Consulta do servidor de nomes em uma zona privada
Atualizado em 2025-08-19 GMT+08:00
Ver PDF
Compartilhar

Consulta do servidor de nomes em uma zona privada

Função

Esta API é usada para consultar o servidor de nomes em uma zona privada.

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 privada a ser consultada

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

Lista de servidores de nomes

Tabela 4 PrivateNameServer

Parâmetro

Tipo

Descrição

priority

Integer

Prioridade. Se o valor de priority for 1, o servidor do DNS é o primeiro a resolver nomes de domínio.

address

String

Endereço do servidor do DNS

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

Exemplo de solicitações

Nenhum

Exemplo de respostas

Código de status: 200

Resposta à solicitação de consulta do servidor de nomes em uma zona privada

{
  "nameservers" : [ {
    "priority" : 1,
    "address" : "100.125.0.81"
  }, {
    "priority" : 2,
    "address" : "100.125.0.82"
  } ]
}

Códigos de status

Código de status

Descrição

200

Resposta à solicitação de consulta do servidor de nomes em uma zona privada

400

Resposta de erro

404

Resposta de erro

500

Resposta de erro

Códigos de erro

Consulte Códigos de erro.