Zonas e registros

Uma zona é o objeto do Edge DNS que contém um domínio, e um registro é um nome, um tipo e um conjunto de valores dentro de uma zona. Edge DNS responde às consultas do domínio da zona pelos três nameservers da Azion assim que o registrador do domínio o delega a eles. Cada tabela abaixo mostra, lado a lado, o rótulo de um campo no Azion Console, o campo na Azion API e a flag na Azion CLI. O formato do valor de cada tipo de registro está em Tipos de registro, e a assinatura de uma zona está em DNSSEC.

Campos da zona

Uma zona tem um nome para sua própria referência, o domínio que ela serve e um estado ativo. No Console, os campos ficam na página Create Zone e na aba Main Settings da zona.

O domínio de uma zona não pode mudar depois da criação: uma atualização que envia domain é recusada com 19036, e o Console bloqueia Domain Name na aba Main Settings. Para servir outro domínio, crie outra zona.

Uma zona inativa não é respondida: os nomes dela recebem a resposta REFUSED. A desativação, como qualquer alteração, pode levar alguns minutos para chegar a todos os nameservers, que servem respostas em cache até lá. Para o cache por trás desse atraso, consulte Como o Edge DNS funciona.

A API acrescenta três campos somente leitura a uma zona: id, o identificador da zona; nameservers, os três nameservers do Edge DNS; e product_version, que mostra 2.0. azion describe dns-zone --zone-id <zone-id> imprime os mesmos valores como ID:, Nameservers: e Product Version:.

No Console, a ação Delete fica na linha da zona na lista Zones, e a página de edição não tem controle de exclusão. O diálogo avisa que a zona é excluída com todas as configurações associadas e que a ação não pode ser revertida, e pede que você digite o nome da zona. Para o procedimento completo, consulte Crie, edite ou exclua uma zona.

Campos do registro

Um registro pertence a uma zona: a API o cria no caminho dessa zona, e o Console o lista na aba Records dessa zona, nos drawers Create Record e Edit Record. Um POST com {"name":"www","type":"A","rdata":["192.0.2.1"],"ttl":3600} armazena o registro abaixo, e a API preenche os campos que a requisição omite:

A API também retorna id, o identificador somente leitura do registro, que os comandos de registro da CLI recebem como --record-id.

O nome de um registro é relativo à zona, então Edge DNS acrescenta o domínio da zona ao que você digitar. Por exemplo, em uma zona cujo domínio é example.com, um registro chamado www.example.com responde por www.example.com.example.com, e uma consulta por www.example.com não recebe resposta dele. Por isso, o Console mostra o domínio como sufixo depois do campo Name.

O dropdown Record Type nomeia cada tipo com uma descrição curta. O formato do valor e as regras de cada tipo estão na entrada dele em Tipos de registro:

Para delegar um subdomínio a outros nameservers, adicione um registro NS no nome do subdomínio.

Um nome e um tipo comportam um registro simples. Um segundo registro com o mesmo nome e o mesmo tipo de um registro simples é recusado com 19004; para responder com vários valores, coloque todos eles no valor de um único registro. Um CNAME também bloqueia todos os outros tipos no nome dele, e um registro de outro tipo nesse nome é recusado com 19018.

Uma zona ou um registro salvo não precisa de etapa de implantação, mas as respostas chegam aos nameservers por meio de um cache. Um nome que ninguém consultou antes de você criá-lo responde em segundos. Um nome consultado antes de existir recebe a resposta NXDOMAIN por até uma hora, o mínimo do SOA. Uma alteração em um registro existente pode levar alguns minutos para chegar a todos os nameservers. Para os detalhes, consulte Como o Edge DNS funciona.

Nameservers e SOA

Toda zona é servida pelos mesmos três nameservers do Edge DNS e tem um registro start of authority (SOA) que a Azion escreve. Para tornar Edge DNS autoritativo para um domínio, delegue o domínio aos três no registrador do domínio.

Os nameservers são somente leitura. A API os retorna no array nameservers da zona, e a aba Main Settings da zona os lista em Configure your Nameserver, cada um com um botão de cópia. Na lista Zones, Copy Nameserver Values copia os três como uma única string separada por ponto e vírgula: ns1.aziondns.net;ns2.aziondns.com;ns3.aziondns.org.

O registro SOA nomeia o nameserver primário e o contato de uma zona, e define os timers dela. Você não pode escrever um: a API recusa SOA como tipo de registro com 10039. Uma consulta pelo SOA de uma zona em ns1.aziondns.net retorna estes valores:

O minimum é por quanto tempo uma resposta negativa, como NXDOMAIN para um nome que não existe, pode ficar em cache, e os nameservers da Azion também a mantêm em cache, por até uma hora. Para o que isso significa quando você adiciona um registro, consulte Como o Edge DNS funciona.

Permissões

Duas permissões da conta controlam Edge DNS. View Edge DNS dá acesso para ver as zonas da conta, sem criá-las nem removê-las. Edit Edge DNS dá acesso para criar, editar e remover zonas, e exige View Edge DNS. Para saber como as permissões são concedidas, consulte Permissões de equipes.

API e CLI

A URL base da API é https://api.azion.com/v4. Toda requisição leva o cabeçalho Authorization: Token [TOKEN VALUE], com um personal token da conta. A Azion CLI executa as mesmas operações:

Um PATCH altera apenas os campos que você envia. Um PUT substitui o objeto: uma zona recebe name e active, e um registro recebe name, type e rdata. Uma criação ou uma atualização retorna {"state":"executed","data":{…}}, uma leitura retorna {"data":{…}}, e uma exclusão retorna {"state":"executed"}.

Uma lista retorna count, total_pages, page, page_size e os objetos em results. Uma página de lista contém até 100 itens, definidos com o parâmetro de query page_size; a CLI recebe --page e --page-size, com 50 itens por página por padrão.

Escreva um booleano da CLI com sinal de igual: --active=true, --active=false, --enabled=true, --enabled=false.

Erros

A API recusa cada requisição abaixo com HTTP 400 e não altera nada, exceto 10001 e 10002, que retornam 401, e 10004, que retorna 404. Cada entrada do array errors carrega o código, o título, uma frase detail e um source que nomeia o campo, como /data/name.

Recursos relacionados