Azion CLI dns-record
Comandos da Azion CLI que criam, listam, descrevem, atualizam e excluem os registros de uma zona do Edge DNS, com cada flag e seu tipo.
Os comandos dns-record da Azion CLI criam, listam, descrevem, atualizam e excluem os registros de uma zona do Edge DNS. Um registro é um nome, um tipo e os valores com que o Edge DNS responde por esse nome. Um registro pertence a uma zona, então todo comando recebe o --zone-id dessa zona. Os campos de um registro estão em Zonas e registros. As opções que todo comando aceita, como --format, --out e -y, estão em Opções globais.
Criar
azion create dns-record cria um registro em uma zona, com o nome, o tipo e os valores que você informa:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--description | — | string | — | Descrição do registro. Usada somente quando --policy é weighted. |
--file | — | string | — | Caminho de um arquivo JSON com os atributos do registro. Use - para ler o JSON da entrada padrão. |
--name | — | string | — | Nome do registro dentro da zona, como www. |
--policy | — | string | — | Política de roteamento do registro: simple ou weighted. |
--rdata | — | strings | — | Valores do registro. Repita a flag ou informe uma lista separada por vírgulas para vários valores. |
--ttl | — | int | — | Time to live (TTL) do registro, em segundos. |
--type | — | string | — | Tipo do registro, como A, AAAA, CNAME, MX, TXT ou NS. Os tipos e os formatos dos seus valores estão em Tipos de registro. |
--weight | — | int | — | Peso do registro. Usado somente quando --policy é weighted. |
--zone-id | — | int | — | Obrigatório. ID da zona que guarda o registro. Sem ela, o comando pergunta o ID da zona. |
Este comando cria um registro A chamado www com dois valores e um TTL de 3600 segundos:
O comando imprime o ID do registro:
--rdata divide o seu valor em cada vírgula, então um valor que contém uma vírgula vira vários valores. Com --rdata 'v=spf1 include:a.example.com,b.example.com ~all', o registro armazena v=spf1 include:a.example.com e b.example.com ~all como dois valores. Para manter a vírgula dentro de um valor, envolva o valor em aspas duplas dentro das aspas simples, ou informe o valor em um arquivo JSON com --file.
Este comando cria um registro TXT chamado spf2 cujo único valor contém uma vírgula:
O comando imprime o ID do registro, que armazena o valor inteiro:
Um valor de --type que não é um tipo de registro, como ZZZ, é recusado com este erro:
Listar
azion list dns-record lista os registros de uma zona, 50 por página:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--details | — | — | — | Aceita, mas não adiciona colunas: a lista mantém as colunas ID, NAME, TYPE, TTL e RDATA. |
--filter | — | string | — | Nome pelo qual filtrar a lista. |
--order-by | — | string | — | Campo pelo qual ordenar a lista. |
--page | — | int | 1 | Número da página a retornar. |
--page-size | — | int | 50 | Número de registros em cada página. |
--zone-id | — | int | — | Obrigatório. ID da zona cujos registros o comando lista. |
Este comando lista os registros da zona com ID 1234:
O comando imprime uma linha por registro:
A coluna RDATA junta os valores de um registro com uma vírgula e um espaço. O registro spf guarda dois valores e o registro spf2 guarda um, e as duas linhas parecem quase iguais. Para ler cada valor separadamente, descreva o registro com --format json.
Descrever
azion describe dns-record imprime as configurações de um registro:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--record-id | — | int | — | Obrigatório. ID do registro a descrever. |
--zone-id | — | int | — | Obrigatório. ID da zona que guarda o registro. |
Este comando descreve o registro com ID 100001:
O comando imprime o nome, o tipo, os valores e as configurações de roteamento do registro:
Com --format json, o comando imprime description, id, name, policy, rdata, ttl, type e weight, com rdata como um array de um item por valor. Um registro criado sem --policy guarda a política simple e o peso 255.
Um ID de registro que não existe na zona falha com este erro:
Atualizar
azion update dns-record altera o nome, o tipo, os valores, o TTL ou as configurações de roteamento de um registro:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--description | — | string | — | Descrição do registro. Usada somente quando --policy é weighted. |
--file | — | string | — | Caminho de um arquivo JSON com os atributos a alterar. Use - para ler o JSON da entrada padrão. |
--name | — | string | — | Novo nome do registro dentro da zona. |
--policy | — | string | — | Política de roteamento do registro: simple ou weighted. |
--rdata | — | strings | — | Valores do registro. Repita a flag ou informe uma lista separada por vírgulas para vários valores. |
--record-id | — | int | — | Obrigatório. ID do registro a atualizar. |
--ttl | — | int | — | Time to live (TTL) do registro, em segundos. |
--type | — | string | — | Tipo do registro, como A, AAAA, CNAME, MX, TXT ou NS. |
--weight | — | int | — | Peso do registro. Usado somente quando --policy é weighted. |
--zone-id | — | int | — | Obrigatório. ID da zona que guarda o registro. |
--rdata substitui todos os valores do registro e divide o seu valor em cada vírgula, como na criação.
Este comando define um valor e um TTL de 7200 segundos no registro com ID 100001:
O comando confirma a atualização:
O registro passa a guardar o valor único 192.0.2.3, e o seu nome e o seu tipo continuam www e A.
Excluir
azion delete dns-record exclui um registro de uma zona:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--record-id | — | int | — | Obrigatório. ID do registro a excluir. |
--zone-id | — | int | — | Obrigatório. ID da zona que guarda o registro. |
Este comando exclui o registro com ID 100001:
O comando confirma a exclusão:
Usar um arquivo JSON
azion create dns-record e azion update dns-record leem os atributos do registro de um arquivo JSON com --file. A zona continua na linha de comando como --zone-id e, na atualização, o registro continua na linha de comando como --record-id.
No arquivo, rdata é um array com um item por valor, então uma vírgula dentro de um valor continua fazendo parte dele. Este arquivo cria um registro TXT chamado txt com um valor e um TTL de 300 segundos:
Informe o arquivo ao comando de criação:
O comando imprime o ID do registro:
Na atualização, o comando altera somente os campos do arquivo, e os campos que você deixa de fora mantêm os seus valores. Este arquivo substitui o valor do registro e define um TTL de 600 segundos:
Informe o arquivo ao comando de atualização:
O comando confirma a atualização:
O registro mantém o nome txt e o tipo TXT, e guarda o valor v=spf1 -all com um TTL de 600 segundos.