Configuração do status de uma zona pública
Função
Esta API é usada para configurar o status de uma zona pública. Você pode suspender ou habilitar uma zona.
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
PUT /v2/zones/{zone_id}/statuses
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
zone_id |
Sim |
String |
ID da zona cujo status a ser configurado |
Parâmetros 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âmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
status |
Sim |
String |
Status da zona. Opções de valor:
|
Parâmetros de resposta
Código de status: 200
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 |
|
String |
Endereço de e-mail do administrador que gerencia a zona |
zone_type |
String |
Tipo de zona. O valor pode ser public ou private. |
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 região. O número de sequência é usado para sincronização entre os nós mestre e subordinado. |
status |
String |
Status do recurso |
record_num |
Integer |
Número de conjuntos de registros na zona |
pool_id |
String |
ID do pool da região, atribuído pelo sistema |
project_id |
String |
ID do projeto da região |
created_at |
String |
Tempo de criação |
updated_at |
String |
Hora da atualização |
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. |
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
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
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
{ "status" : "DISABLE" }
Exemplo de respostas
Código de status: 200
Resposta à solicitação de atualização do status de uma zona pública
{ "id" : "2c9eb155587194ec01587224c9f90149", "name" : "example.com.", "description" : "This is an example zone.", "email" : "xx@example.com", "ttl" : 300, "serial" : 0, "masters" : [ ], "status" : "DISABLE", "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.528", "record_num" : 2 }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
Resposta à solicitação de atualização do status de uma zona pública |
400 |
Resposta de erro |
500 |
Resposta de erro |
Códigos de erro
Consulte Códigos de erro.