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/ Modificação de uma zona pública
Atualizado em 2025-08-19 GMT+08:00
Ver PDF
Compartilhar

Modificação de uma zona pública

Função

Esta API é usada para modificar 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

PATCH /v2/zones/{zone_id}

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

zone_id

Sim

String

ID da zona a ser modificada

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.
Tabela 3 Parâmetros de corpo de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

description

Não

String

Descrição da zona. São permitidos no máximo 255 caracteres.

email

Não

String

Endereço de e-mail do administrador que gerencia a zona. Se este parâmetro for deixado em branco, o valor original é mantido. É deixado em branco por padrão.

ttl

Não

Integer

Duração do armazenamento em cache do conjunto de registros SOA (em segundos)

Parâmetros de resposta

Código de status: 200

Tabela 4 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

id

String

ID da zona, um UUID usado para identificar a zona

name

String

Nome da zona

description

String

Descrição da zona

email

String

Endereço de e-mail do administrador que gerencia a zona

zone_type

String

Tipo de zona. O valor é public.

ttl

Integer

Valor TTL do conjunto de registros SOA na região

serial

Integer

Número de sequência usado para identificar alterações no arquivo de zona no conjunto de registros SOA da zona, usado para sincronização entre os nós mestre e subordinado. Este parâmetro é reservado.

status

String

Status do recurso.

record_num

Integer

Número de conjuntos de registros na zona

pool_id

String

Pool que hospeda a zona. O pool é atribuído pelo sistema.

project_id

String

ID do projeto da região

created_at

String

Tempo de criação. A hora UTC no formato AAAA-MM-DDTHH:MM:SSZ é necessária.

updated_at

String

Hora da atualização. A hora UTC no formato AAAA-MM-DDTHH:MM:SSZ é necessária.

links

pageLink object

Link do recurso atual ou outros recursos relacionados. Quando uma resposta é dividida em páginas, um próximo link é fornecido para recuperar todos os resultados.

masters

Array of strings

Servidores do DNS mestre, dos quais os servidores subordinados obtêm informações do DNS.
Tabela 5 pageLink

Parâmetro

Tipo

Descrição

self

String

Link para o recurso atual

next

String

Link para a próxima página

Código de status: 400

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: 404

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

Código de status: 500

Tabela 8 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

{
  "description" : "This is an example zone.",
  "email" : "xx@example.org",
  "ttl" : 300
}

Exemplo de respostas

Código de status: 200

Resposta à solicitação de modificação de uma zona pública

{
  "id" : "2c9eb155587194ec01587224c9f90149",
  "name" : "example.com.",
  "description" : "This is an example zone.",
  "email" : "xx@example.com",
  "ttl" : 300,
  "serial" : 1,
  "masters" : [ ],
  "status" : "ACTIVE",
  "links" : {
    "self" : "https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149"
  },
  "pool_id" : "00000000570e54ee01570e9939b20019",
  "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c",
  "zone_type" : "public",
  "created_at" : "2016-11-17T11:56:03.439",
  "updated_at" : "2016-11-17T11:56:05.749",
  "record_num" : 2
}

Códigos de status

Código de status

Descrição

200

Resposta à solicitação de modificação de 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.