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 Chamada das API 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.
