Modificação de uma zona privada
Função
Esta API é usada para modificar uma zona privada.
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
PATCH /v2/zones/{zone_id}
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
zone_id |
Sim |
String |
ID da zona a ser modificada |
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 |
---|---|---|---|
description |
Não |
String |
Descrição da zona. São permitidos no máximo 255 caracteres. |
|
Não |
String |
Endereço de e-mail do administrador que gerencia a zona |
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
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 zona, 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 mestres DNS, dos quais os servidores subordinados obtêm informações do DNS. |
routers |
Array of RouterWithStatus objects |
Informações sobre a VPC associada à zona privada |
Parâmetro |
Tipo |
Descrição |
---|---|---|
self |
String |
Link para o recurso atual |
next |
String |
Link para a próxima página |
Parâmetro |
Tipo |
Descrição |
---|---|---|
status |
String |
Status do recurso |
router_id |
String |
ID da VPC associada à zona |
router_region |
String |
Região da VPC |
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: 404
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
{ "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 privada
{ "id" : "ff8080825b8fc86c015b94bc6f8712c3", "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/ff8080825b8fc86c015b94bc6f8712c3" }, "pool_id" : "ff8080825ab738f4015ab7513298010e", "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c", "zone_type" : "private", "created_at" : "2017-04-22T08:17:08.997", "updated_at" : "2017-04-22T08:17:10.849", "record_num" : 2, "routers" : [ { "status" : "ACTIVE", "router_id" : "19664294-0bf6-4271-ad3a-94b8c79c6558", "router_region" : "xx" } ] }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
Resposta à solicitação de modificação de uma zona privada |
400 |
Resposta de erro |
404 |
Resposta de erro |
500 |
Resposta de erro |
Códigos de erro
Consulte Códigos de erro.