--- name: azion-aponte-um-dominio-raiz-com-aname description: >- Aponte o seu domínio raiz, como example.com, para um hostname da Azion com um registro ANAME do Edge DNS, pelo Azion Console, pela Azion CLI ou pela API. --- # Aponte um domínio raiz com ANAME Você pode apontar um domínio raiz para um hostname da Azion com um registro ANAME no [Edge DNS](/pt-br/documentacao/plataforma/edge-dns/) pelo Azion Console, pela Azion CLI ou pela Azion API. Edge DNS então responde às consultas pelo apex com os endereços desse hostname. Para apontar um subdomínio como `www`, consulte [Aponte um subdomínio com CNAME](/pt-br/documentacao/guias/seguranca-de-aplicacoes/dns/subdominio-cname/). O apex, também chamado de domínio raiz ou naked domain, é o seu domínio sem nenhum subdomínio, como `example.com`. Um registro CNAME não pode ficar no apex, então o registro ANAME ocupa o lugar dele ali. Para entender o motivo, consulte [Como o Edge DNS funciona](/pt-br/documentacao/plataforma/edge-dns/como-funciona/#aname-no-apex). --- Selecione a sua interface uma vez. Os pré-requisitos e a primeira tarefa mostram apenas esse caminho. ## Pré-requisitos - Uma zona para o seu domínio no Edge DNS. Para criar uma, consulte [Crie, edite ou exclua uma zona](/pt-br/documentacao/guias/seguranca-de-aplicacoes/dns/edge-dns-definir-main-settings/). - A permissão **Edit Edge DNS**, que requer **View Edge DNS**. Consulte [Permissões de equipes](/pt-br/documentacao/fundamentos/teams-permissions/). - O hostname da Azion para o qual o registro aponta, como o domínio do workload `.map.azionedge.net`. Para encontrá-lo e fazer o workload aceitar o seu domínio raiz, consulte [Aponte um domínio para um workload](/pt-br/documentacao/guias/plataforma/migracao/apontar-dominio-para-a-azion/). **Console** - Acesso ao Azion Console. Para entrar, consulte [Como acessar o Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/). **CLI** - A [Azion CLI](/pt-br/documentacao/devtools/cli/) instalada e autorizada. - O ID da sua zona. `azion list dns-zone` o mostra na coluna `ID`. **API** - Um [personal token](/pt-br/documentacao/guias/plataforma/conta-e-billing/personal-tokens/) e `curl`. - O `id` da sua zona. Uma requisição `GET` para `https://api.azion.com/v4/workspace/dns/zones` lista todas as zonas com o `id` de cada uma. - Para todos os endpoints e campos da API, consulte a [referência da Azion API](https://api.azion.com/). --- ## Adicione o registro ANAME no apex O nome de registro `@` representa o apex. O valor é um hostname sob `azioncdn.net`, `azionedge.net` ou `azionedge.com`, e o TTL é sempre `20`. Para editar ou excluir o registro depois, consulte [Adicione, edite ou exclua um registro](/pt-br/documentacao/guias/seguranca-de-aplicacoes/dns/adicionar-registros/). **Console** Para adicionar o registro pelo Azion Console: 1. **Abra a página do Edge DNS** Acesse [Azion Console](https://console.azion.com/) > **Edge DNS**. 2. **Abra a zona** Na página **Zones**, selecione a linha da zona que contém o seu domínio. 3. **Selecione a aba Records** 4. **Selecione + Record** O drawer **Create Record** é aberto. 5. **Informe @ como nome** Em **Name**, informe `@`. O Console adiciona o domínio para você, então o registro responde por `example.com`. 6. **Selecione o tipo de registro ANAME** Em **Record Type**, selecione *ANAME - Maps a name to another name*. O Console define **TTL (seconds)** como `20`. 7. **Mantenha o TTL em 20** Deixe **TTL (seconds)** em `20`. Edge DNS recusa qualquer outro TTL para um registro ANAME. 8. **Informe o hostname** Em **Value**, informe o hostname da Azion, como `.map.azionedge.net`. Informe um hostname, nunca um endereço IP. 9. **Mantenha a política Simple** Na seção **Policy**, mantenha **Policy Type** em *Simple*. O campo **Weight** fica indisponível para um registro ANAME. 10. **Selecione Save** O Console mostra `Edge DNS Record has been created`, e o registro aparece na tabela **Records**. **CLI** Para adicionar o registro pela Azion CLI, substitua `` pelo ID da sua zona e o valor pelo seu hostname: ```bash azion create dns-record --zone-id --name @ --type ANAME --rdata .map.azionedge.net --ttl 20 ``` O comando mostra o ID do registro: ```text Created DNS record with ID 100779 ``` A zona contém o registro ANAME no apex. Em `--name`, `@` representa o domínio: nunca digite o próprio domínio. **API** Para adicionar o registro pela Azion API, envie uma requisição `POST` ao endpoint de registros da zona. Substitua `` pelo `id` da sua zona e o valor em `rdata` pelo seu hostname: ```bash curl -X POST https://api.azion.com/v4/workspace/dns/zones//records \ -H "Authorization: Token [TOKEN VALUE]" \ -H "Content-Type: application/json" \ -d '{"name":"@","type":"ANAME","rdata":[".map.azionedge.net"],"ttl":20}' ``` Um `201` retorna o registro: ```json { "state": "executed", "data": { "id": 100186, "description": "", "name": "@", "ttl": 20, "type": "ANAME", "rdata": [".map.azionedge.net"], "policy": "simple", "weight": 255 } } ``` A zona contém o registro ANAME no apex. Em `name`, `@` representa o domínio: nunca envie o próprio domínio. A API recusa um registro ANAME com qualquer TTL diferente de `20` com `19011`, e um hostname fora dos três domínios da Azion com `19016`. Para todas as regras do tipo, consulte [Tipos de registro](/pt-br/documentacao/plataforma/edge-dns/tipos-de-registro/#aname). --- ## Consulte o apex nos nameservers da Azion Consulte o nameserver da Azion diretamente, sem o cache do seu resolver, para confirmar que ele responde pelo apex. Esta verificação funciona antes de o seu registrador delegar o domínio à Azion. Para consultar o apex em `ns1.aziondns.net`, substitua `example.com` pelo seu domínio: ```bash dig +short @ns1.aziondns.net example.com A ``` O nameserver retorna os endereços do hostname, um por linha: ```text
``` O próprio Edge DNS consulta o hostname e responde pelo apex com os endereços dele como registros A. Sem `+short`, a saída mostra `status: NOERROR`, a flag `aa`, um TTL de `20` em cada registro A e nenhum CNAME na resposta. Se o comando não mostrar nada, aguarde alguns minutos e execute-o novamente. Depois que você adiciona ou altera um registro, a alteração pode levar alguns minutos para chegar a todos os nameservers. Para mais informações, consulte [Como o Edge DNS funciona](/pt-br/documentacao/plataforma/edge-dns/como-funciona/#cache-e-propagacao). Os resolvers na internet só usam o registro depois que o seu registrador delega o domínio aos três nameservers do Edge DNS. Para a delegação, consulte [Migre nameservers para a Azion](/pt-br/documentacao/guias/plataforma/migracao/migrar-ns-para-a-azion/). --- ## Próximos passos - [Migre nameservers para a Azion](/pt-br/documentacao/guias/plataforma/migracao/migrar-ns-para-a-azion.md): Delegue o seu domínio ao Edge DNS para que os resolvers usem o registro. - [Aponte um domínio para um workload](/pt-br/documentacao/guias/plataforma/migracao/apontar-dominio-para-a-azion.md): Faça o workload aceitar o seu domínio raiz e confira se ele resolve. - [Tipos de registro](/pt-br/documentacao/plataforma/edge-dns/tipos-de-registro.md#aname): Todas as regras do registro ANAME e dos outros tipos. - [Aponte um subdomínio com CNAME](/pt-br/documentacao/guias/seguranca-de-aplicacoes/dns/subdominio-cname.md): Envie um nome como www para outro host.