Aponte um subdomínio com CNAME

Torne um subdomínio um alias de outro hostname com um registro CNAME do Edge DNS, pelo Azion Console, pela Azion CLI ou pela API, e confira a resposta.

Última atualização

Ver como Markdown Configurar agente

Você pode apontar um subdomínio para outro host com um registro CNAME no Edge DNS pelo Azion Console, pela Azion CLI ou pela Azion API. O registro abaixo torna blog.example.com um alias de www.example.com, então uma consulta por blog recebe o endereço de www. Um CNAME não pode ter o nome @: para apontar o domínio raiz, consulte Aponte um domínio raiz com ANAME.

Selecione uma interface. Os pré-requisitos e o procedimento abaixo mudam com ela.

Pré-requisitos

  • Uma zona para o seu domínio no Edge DNS. Para criar uma, consulte Crie, edite ou exclua uma zona.
  • O hostname para o qual o alias aponta. Este exemplo usa www.example.com, um registro A em www na mesma zona, que responde 192.0.2.1.
  • A permissão Edit Edge DNS. Ela requer View Edge DNS. Consulte Permissões de equipes.
  • A Azion CLI instalada e autorizada.
  • O ID da zona. azion list dns-zone o mostra na coluna ID.

Adicione o registro CNAME

O nome do registro é relativo à zona: você informa blog, e o Edge DNS o serve como blog.example.com. O valor é o único hostname para o qual o alias aponta. Substitua example.com pelo seu domínio em todas as etapas.

Para adicionar o registro CNAME pela Azion CLI, substitua <zone-id> pelo ID da sua zona e execute:

azion create dns-record --zone-id <zone-id> --name blog --type CNAME --rdata www.example.com --ttl 3600

O comando mostra o ID do registro:

Created DNS record with ID 100774

A zona contém o alias. Passe apenas blog em --name: um nome digitado com o domínio é servido com o domínio duas vezes.

Para adicionar o registro CNAME pela Azion API, envie uma requisição POST ao endpoint de registros da zona. Substitua <zone-id> pelo id da sua zona e [TOKEN VALUE] pelo seu personal token:

Shell
01curl -X POST https://api.azion.com/v4/workspace/dns/zones/<zone-id>/records \
02 -H "Authorization: Token [TOKEN VALUE]" \
03 -H "Content-Type: application/json" \
04 -d '{"name":"blog","type":"CNAME","rdata":["www.example.com"],"ttl":3600}'

Um 201 retorna o registro:

JSON
01{
02 "state": "executed",
03 "data": {
04 "id": 100177,
05 "description": "",
06 "name": "blog",
07 "ttl": 3600,
08 "type": "CNAME",
09 "rdata": ["www.example.com"],
10 "policy": "simple",
11 "weight": 255
12 }
13}

A zona contém o alias. rdata carrega o único hostname de destino, e policy e weight mantêm os seus valores padrão.

Para adicionar o registro CNAME pelo Azion Console:

Abra a página do Edge DNS

Acesse Azion Console > Edge DNS.

Abra a zona

Na página Zones, selecione a linha da zona.

Selecione a aba Records
Selecione + Record

O drawer Create Record é aberto.

Informe o subdomínio

Em Name, informe blog. O Console mostra o seu domínio depois do campo e o adiciona para você.

Selecione o tipo CNAME

Em Record Type, selecione CNAME - Canonical name.

Mantenha o TTL

Mantenha TTL (seconds) em 3600.

Informe o hostname de destino

Em Value, informe www.example.com.

Selecione Save

O Console mostra Edge DNS Record has been created, e blog aparece na tabela Records.

Depois que blog contém o CNAME, ele não contém nenhum outro tipo de registro: o Edge DNS recusa um registro MX ou CAA em blog com 19018. Para todas as regras de CNAME e os seus erros, consulte Tipos de registro.

Confira a resposta

Consulte o nameserver da Azion diretamente, sem o cache do seu resolver. Esta verificação funciona antes de você delegar o domínio à Azion.

Para consultar o alias em ns1.aziondns.net, substitua example.com pelo seu domínio:

dig +short @ns1.aziondns.net blog.example.com A

O nameserver retorna o hostname de destino e, depois, o endereço do destino:

Texto
01www.example.com.
02192.0.2.1

O destino está na mesma zona, então o Edge DNS responde o CNAME e o registro A de www em uma única resposta. Um nome que ninguém consultou antes de você salvá-lo responde em segundos. Uma alteração posterior no registro pode levar alguns minutos para chegar a todos os nameservers. Para saber como as respostas ficam em cache, consulte Como o Edge DNS funciona.

Se o comando não mostrar nada, consulte Um registro novo retorna NXDOMAIN.

Próximos passos

Aponte um domínio raiz com ANAMEResponda pelo domínio raiz, onde um CNAME é recusado.Tipos de registroTodas as regras de CNAME e o erro que a API retorna para cada uma.Adicione, edite ou exclua um registroAltere o destino do alias ou exclua-o.Migre nameservers para a AzionDelegue o domínio para que resolvers públicos consultem o Edge DNS.