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

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
}