Criação de uma zona privada
Função
Esta API é usada para criar 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
POST /v2/zones
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 |
|---|---|---|---|
|
name |
Sim |
String |
Zona a ser criada |
|
description |
Não |
String |
Descrição da zona |
|
zone_type |
Sim |
String |
Tipo de zona. O valor é private. |
|
|
Não |
String |
Endereço de e-mail do administrador que gerencia a zona |
|
ttl |
Não |
Integer |
Duração do cache do conjunto de registros SOA (em segundos) |
|
router |
Sim |
Router object |
VPC a ser desassociada |
|
proxy_pattern |
Não |
String |
Modo proxy de resolução recursiva para nomes de subdomínio de zonas privadas. Opções de valor:
|
|
tags |
Não |
Array of tag objects |
Tag de recurso |
|
enterprise_project_id |
Não |
String |
ID do projeto corporativo associado à zona. O valor contém no máximo 36 caracteres. O valor padrão é 0. |
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
router_id |
Sim |
String |
ID da VPC associada à zona |
|
router_region |
Não |
String |
Região da VPC |
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
key |
Sim |
String |
Chave da tag. Uma chave pode conter até 36 caracteres Unicode. Não pode ser deixada em branco. Um valor de tag não pode conter caracteres especiais (=*<>,|/) nem iniciar ou terminar com espaços. |
|
value |
Não |
String |
Valor da tag. Um valor de tag contém no máximo 43 caracteres Unicode e pode ser deixado em branco. Um valor de tag não pode conter caracteres especiais (=*<>,|/) nem iniciar ou terminar com espaços. |
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 zona |
|
serial |
Integer |
Número de sequência usado para identificar alterações no arquivo de zona no conjunto de registros SOA da zona. O número de sequência é 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 |
|
proxy_pattern |
String |
Modo proxy de resolução recursiva para nomes de subdomínio de zonas privadas. Opções de valor:
|
|
pool_id |
String |
ID do pool da zona, atribuído pelo sistema |
|
project_id |
String |
ID do projeto da zona |
|
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 mestres DNS, dos quais os servidores subordinados obtêm informações do DNS. |
|
router |
RouterWithStatus object |
Lista de VPCs associadas à zona |
|
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
{
"name" : "example.com.",
"description" : "This is an example zone.",
"zone_type" : "private",
"email" : "xx@example.org",
"router" : {
"router_id" : "19664294-0bf6-4271-ad3a-94b8c79c6558",
"router_region" : "xx"
},
"proxy_pattern" : "AUTHORITY",
"tags" : [ {
"key" : "key1",
"value" : "value1"
} ]
}Exemplo de respostas
Código de status: 200
Resposta à solicitação de criaçã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" : "PENDING_CREATE",
"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" : null,
"record_num" : 0,
"proxy_pattern" : "AUTHORITY",
"router" : {
"status" : "PENDING_CREATE",
"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 criaçã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.
