Como apontar um domínio para a Azion

Aponte o registro do seu domínio para o seu domínio Azion, garantindo uma experiência de usuário perfeita com sua application.

Ver como Markdown

Importante — Estamos lançando uma atualização significativa em nossa plataforma. Para saber mais sobre as mudanças e etapas de migração necessárias, consulte a página de rollout da API v4.

Se você já possui um domínio, pode associar o registro CNAME do seu domínio personalizado ao endereço do seu Azion Workload Domain, efetivamente direcionando acesso à sua application.

Antes de direcionar seu tráfego para a Azion, você pode testar seu domínio personalizado no edge localmente ao fazer o staging da sua aplicação através do arquivo hosts.

Este processo exigirá que você associe um registro CNAME ao seu domínio. Para associar um registro ANAME, migre seus nameservers para a Azion.

Dica — Neste guia, existem instruções separadas para API v3 e API v4. Se você não tem certeza de quais passos se aplicam à sua conta, consulte o guia Verifique a migração da sua conta para a API v4 para determinar se sua conta já foi migrada.

Passo 1: Verifique o domínio personalizado

Para apontar seu domínio Azion para um domínio personalizado, você precisa listar os CNAMEs que deseja configurar para a aplicação:

Acesse o Azion Console > Workloads.
Clique no domínio que você deseja associar ao seu domínio personalizado.
Nos campos Subdomain e Domain, adicione os domínios personalizados para a aplicação. Por exemplo: seudominio.com e *.seudominio.com.
Desative a opção Workload Domain Allow Access.
Clique no botão Save.

Agora, seu Azion Workload está pronto para ser associado a um domínio personalizado no seu provedor de DNS.

Acesse o Azion Console > Domains.
Clique no domínio que você deseja associar ao seu domínio personalizado.
No campo CNAME, adicione os domínios personalizados para a aplicação. Por exemplo: seudominio.com e *.seudominio.com.
Ative a opção CNAME Access Only.
Clique no botão Save.

Agora, seu domínio Azion está pronto para ser associado a um domínio personalizado no seu provedor de DNS.

Execute a seguinte requisição GET para recuperar o ID do seu workload, substituindo [TOKEN VALUE] pelo seu personal token:

curl --request GET --url https://api.azion.com/v4/workspace/workloads --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]'

Você receberá uma resposta semelhante a esta:

{

"count": 3,

"results": [

{

"id": "<workload_id>",

"name": "My workload",

"active": true,

"last_editor": "your-email.example.com",

"last_modified": "2025-08-06T17:53:47.460211Z",

"infrastructure": 1,

"tls": {

"certificate": null,

"ciphers": 7,

"minimum_version": "tls_1_3"

},

"protocols": {

"http": {

"versions": [

"http1",

"http2"

],

"http_ports": [

80

],

"https_ports": [

443

],

"quic_ports": null

}

},

"mtls": {

"verification": null,

"certificate": null,

"crl": null

},

"domains": [

"xxxxxxx.azion.app"

],

"workload_domain_allow_access": false,

"workload_domain": "xxxxxxxx.map.azionedge.net",

"product_version": "1.0"

}

Localize o workload que você deseja vincular ao domínio personalizado e copie o valor workload_id recebido na resposta.
Execute uma requisição PATCH, substituindo [TOKEN VALUE] pelo seu personal token e adicionando o workload_id como um caminho, para atualizar o campo domains com os domínios que você deseja configurar:

curl --request PATCH --url https://api.azion.com/v4/workspace/workloads/<workload_id> --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data {

"domains": [

"yourdomain.com",

"*.yourdomain.com"

]

}

Chave	Descrição
`domains`	Aceita uma lista de CNAMEs para os workloads como valores. Por exemplo, `[".seudominio.com", ".seudominio.org"]`.

Se sua aplicação usa HTTPS, você pode combinar este processo com a associação de um certificado digital ao seu domínio personalizado.

Você deve receber uma resposta com os dados atualizados.

Execute a seguinte requisição GET para recuperar o ID do seu domínio, substituindo [TOKEN VALUE] pelo seu personal token:

curl --location 'https://api.azionapi.net/domains' --header 'Accept: application/json; version=3' --header 'Authorization: Token [TOKEN VALUE]'

Você receberá uma resposta semelhante a esta:

{

...

"results": [

{

"id": <domain_id>,

"name": "seudominio.com CA1 DC-seudominio.com",

"cnames": [],

"cname_access_only": true,

"digital_certificate_id": <digital_certificate_id>,

"edge_application_id": <edge_application_id>,

"is_active": true,

"domain_name": "xxxxxxxxxx.map.azionedge.net"

}

]

}

Localize o domínio que você deseja vincular ao domínio personalizado e copie o valor domain_id recebido na resposta.
Execute uma requisição PATCH, substituindo [TOKEN VALUE] pelo seu personal token e adicionando o domain_id como um caminho, para atualizar o campo cnames com os domínios que você deseja configurar:

curl --location --request PATCH 'https://api.azionapi.net/domains/<domain_id>' --header 'Accept: application/json; version=3' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data {

"cnames": [

"seudominio.com",

"*.seudominio.com"

]

}

Chave	Descrição
`cnames`	Aceita uma lista de CNAMEs para os domínios como valores. Por exemplo, `[".seudominio.com", ".seudominio.org"]`.

Se sua application usa HTTPS, você pode combinar este processo com a associação de um certificado digital ao seu domínio personalizado.

Você deve receber uma resposta com os dados atualizados.

Passo 2: Modifique os registros de domínio

Uma vez que você tenha um domínio, você precisa acessar seu provedor de DNS e localizar a área de gerenciamento de registros. Lá, você pode modificar cada entrada associada ao seu domínio. A entrada que você precisa associar ao seu domínio Azion é um registro CNAME.

Alguns serviços não permitem que você altere sua resolução ANAME diretamente. Para apontar seu registro ANAME para a sua aplicação, migre seus nameservers para a Azion.

No seu provedor de DNS, você pode adicionar ou modificar um registro CNAME www e associá-lo à sua application. Veja a documentação sobre como editar registros de domínio de alguns dos provedores de DNS mais populares abaixo:

Para configurar seus registros de DNS:

Faça login no seu provedor de DNS.
Escolha o seu domínio.
Localize a página onde você pode modificar os registros de DNS para o seu domínio.
Crie ou edite o registro CNAME www do seu domínio preenchendo as informações:

Nome	Valor	Tipo
`www`	`xxxxxxxxxx.map.azionedge.net`	CNAME

Alguns provedores permitem que você adicione um subdomínio wildcard (*) em vez de um subdomínio específico para cobrir todos os cenários. Desta forma, você não precisará especificar que www.seudominio.com e blog.seudominio.com apontam para a mesma application.

Salve suas configurações.

Note que pode haver um atraso no tempo de propagação quando você acessa sua application. Se for o caso, você pode executar o comando DIG no seu terminal para verificar os registros de DNS do seu nó edge. Por exemplo:

dig +short seudominio.org @200.0.0.0

Uma vez que as alterações tenham se propagado pelo edge, você poderá acessar sua application através do seu domínio personalizado.

Confira a documentação da API da Azion para saber mais sobre todas as funcionalidades disponíveis via API.