Criação de uma zona pública
Função
Esta API é usada para criar 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
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 | Nome da zona |
| description | Não | String | Descrição |
| zone_type | Não | String | Tipo de zona. O valor é public. |
| | Não | String | Caixa de correio do administrador que gerencia a zona |
| ttl | Não | Integer | Duração do cache do conjunto de registros SOA gerado por padrão, em segundos |
| enterprise_project_id | Não | String | ID do projeto corporativo associado ao nome de domínio. O valor contém no máximo 36 caracteres. |
| tags | Não | Array of tag objects | Tag de recurso |
| 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 deixado 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: 202
| 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 é 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 região. O número de sequência é usado para sincronização entre os nós mestre e subordinado. |
| status | String | Estado 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. 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. |
| enterprise_project_id | String | ID do projeto corporativo associado à zona. O valor contém no máximo 36 caracteres. |
| masters | Array of strings | Servidores de DNS mestre, dos quais os servidores subordinados obtêm informações de DNS. Este parâmetro é reservado. |
| 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
{
"name" : "example.com.",
"description" : "This is an example zone.",
"zone_type" : "public",
"email" : "xx@example.org",
"ttl" : 300,
"tags" : [ {
"key" : "key1",
"value" : "value1"
} ]
} Exemplo de respostas
Código de status: 202
Resposta à solicitação de criaçã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" : "PENDING_CREATE",
"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" : null,
"record_num" : 0
} Códigos de status
| Código de status | Descrição |
|---|---|
| 202 | Resposta à solicitação de criação de uma zona pública |
| 400 | Resposta de erro |
| 500 | Resposta de erro |
Códigos de erro
Consulte Códigos de erro.
