Criação de um conjunto de registros
Função
Esta API é usada para criar um conjunto de registros.
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/{zone_id}/recordsets
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| zone_id | Sim | String | ID da zona |
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 de domínio totalmente qualificado (FQDN) com sufixo com um nome de zona, que é um nome de host completo terminado com um ponto |
| description | Não | String | (Opcional) Descrição do nome de domínio. O valor consiste em um máximo de 255 caracteres. Este parâmetro é deixado vazio por padrão. |
| type | Sim | String | Tipo de conjunto de registros. O valor pode ser A, AAAA, MX, CNAME, TXT, NS, SRV ou CAA. |
| status | Não | String | Status do recurso |
| ttl | Não | Integer | Duração do cache do conjunto de registros (em segundos) em um servidor do DNS local. Quanto maior a duração, mais lenta a atualização terá efeito. Se o endereço de serviço mudar com frequência, configure TTL para um valor menor. |
| records | Sim | Array of strings | Valor do conjunto de registros. As regras de valor variam dependendo do tipo de conjunto de registros. |
| 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 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 do conjunto de registros |
| name | String | Nome do conjunto de registros |
| description | String | Descrição do conjunto de registros |
| zone_id | String | ID da zona do conjunto de registros |
| zone_name | String | Nome da zona do conjunto de registros |
| type | String | Tipo de conjunto de registros. O valor pode ser A, AAAA, MX, CNAME, TXT, NS (somente em zonas públicas), SRV ou CAA (somente em zonas públicas). |
| ttl | Integer | Duração do cache do conjunto de registros (em segundos) em um servidor do DNS local. Quanto maior a duração, mais lenta a atualização terá efeito. Se o endereço de serviço mudar com frequência, configure TTL para um valor menor. |
| records | Array of strings | Valor do conjunto de registos |
| create_at | String | Hora em que o conjunto de registros foi criado. Formato: aaaa-MM-dd'T'HH:mm:ss.SSS |
| update_at | String | Hora em que o conjunto de registros foi atualizado. Formato: aaaa-MM-dd'T'HH:mm:ss.SSS |
| status | String | Status do recurso |
| default | Boolean | Se o conjunto de registros é criado por padrão. Um conjunto de registros padrão não pode ser excluído. |
| project_id | String | ID do projeto do conjunto de registros |
| 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. |
Exemplo de solicitações
{
"name" : "www.example.com.",
"description" : "This is an example record set.",
"type" : "A",
"ttl" : 3600,
"records" : [ "192.168.10.1", "192.168.10.2" ],
"tags" : [ {
"key" : "key1",
"value" : "value1"
} ]
} Exemplo de respostas
Código de status: 200
Resposta para criação de um conjunto de registros
{
"id" : "2c9eb155587228570158722b6ac30007",
"name" : "www.example.com.",
"description" : "This is an example record set.",
"type" : "A",
"ttl" : 300,
"records" : [ "192.168.10.1", "192.168.10.2" ],
"status" : "PENDING_CREATE",
"links" : {
"self" : "https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007"
},
"zone_id" : "2c9eb155587194ec01587224c9f90149",
"zone_name" : "example.com.",
"create_at" : "2016-11-17T12:03:17.827",
"update_at" : null,
"default" : false,
"project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c"
} Códigos de status
| Código de status | Descrição |
|---|---|
| 200 | Resposta para criação de um conjunto de registros |
Códigos de erro
Consulte Códigos de erro.
