As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Encaminhar o tráfego para uma API do Amazon API Gateway por meio do seu nome de domínio
Você pode usar o Amazon API Gateway para criar, publicar, manter, monitorar e proteger APIs. Você pode criar APIs esses AWS serviços de acesso ou outros serviços da web, além dos dados armazenados na AWS nuvem.
O método usado para encaminhar o tráfego de domínio para uma API do API Gateway é o mesmo, independentemente de você ter criado um endpoint regional do API Gateway ou um endpoint do API Gateway otimizado para bordas. Se você criar um endpoint privado do API Gateway, o processo será um pouco diferente.
Endpoint de API regional: crie um registro de alias do Route 53 que encaminha o tráfego para o endpoint de API regional.
Endpoint da API otimizado para borda: é criado um registro de alias do Route 53 que encaminha o tráfego para a API otimizada para borda. Isso faz com que o tráfego seja roteado para a CloudFront distribuição associada à API otimizada para borda.
-
Endpoint de API privado: você cria um registro de alias do Route 53 que roteia o tráfego para seu endpoint de API privado usando uma interface VPC endpoint para API Gateway em uma zona hospedada privada.
Um registro de alias é uma extensão do Route 53 para DNS semelhante a um registro CNAME. Para obter uma comparação de registros de alias e CNAME, consulte Escolher entre registros de alias e não alias.
O Route 53 não cobra por consultas de alias no API Gateway APIs ou em outros AWS recursos.
Pré-requisitos
Para começar, faça o seguinte:
Uma API do API Gateway que tem um nome de domínio personalizado, como api.example.com que corresponda ao nome do registro do Route 53 que você deseja criar.
Para obter mais informações, consulte os tópicos a seguir.
Um nome de domínio registrado. Você pode usar o Amazon Route 53 como seu registrador de domínio ou pode usar um registrador diferente.
O Route 53 como serviço de DNS para o domínio. Se você registrar seu nome de domínio usando o Route 53, nós configuraremos automaticamente o Route 53 como o serviço de DNS para o domínio.
Para obter informações sobre como usar o Route 53 como o provedor de serviços DNS de seu domínio, consulte Como transformar o Amazon Route 53 no serviço de DNS para um domínio existente.
Como configurar o Route 53 para encaminhar o tráfego para um endpoint do API Gateway
Para configurar o Route 53 para encaminhar o tráfego para um endpoint do API Gateway, siga o procedimento a seguir.
- Custom domain names for public APIs
-
O procedimento a seguir descreve como rotear o tráfego para um endpoint do API Gateway para obter um nome de domínio personalizado para público APIs.
Para encaminhar o tráfego para um endpoint do API Gateway
Se você criou a zona hospedada do Route 53 e o endpoint regional usando a mesma conta, vá para a etapa 2.
Se você criou a zona hospedada e o endpoint regional usando contas diferentes, obtenha o nome de domínio de destino para o nome de domínio personalizado que você deseja usar:
Faça login no AWS Management Console e abra o console do API Gateway em https://console.aws.amazon.com/apigateway/.
No painel de navegação, selecione Nomes de domínio personalizados.
Selecione o nome de domínio personalizado que você deseja usar e obtenha o valor de API Gateway domain name (Nome de domínio do API Gateway).
Abra o console do Route 53 em https://console.aws.amazon.com/route53/.
No painel de navegação, escolha Zonas hospedadas.
Selecione o nome da zona hospedada com o nome de domínio que você deseja usar para rotear o tráfego para sua API.
Escolha Create record (Criar registro).
Especifique os seguintes valores:
Recomendamos que você ative Alias. Para nomes de domínio que não usam um registro de alias do Route 53, você pode ter problemas se usar uma VPC com DNS privado habilitado para invocar uma API privada. O DNS privado substitui o comportamento padrão de resolução de DNS na VPC, o que pode causar conflitos com registros DNS externos.
- Política de roteamento
-
Selecione a política de roteamento aplicável. Para obter mais informações, consulte Escolher uma política de roteamento.
- Nome de registro
-
Insira o nome de domínio que você deseja usar para rotear o tráfego para sua API.
A API para a qual você deseja encaminhar o tráfego deve incluir um nome de domínio personalizado, como api.example.com que corresponda ao nome do registro do Route 53.
- Alias
-
Se você estiver usando o método de criação de registro Quick create (Criação rápida), ative o Alias.
- Valor/Encaminhar tráfego para
-
Escolha Alias to API Gateway API (Alias para API do API Gateway) e, em seguida, escolha a região de origem do endpoint.
A forma como você especifica o valor do Endpoint depende se você criou a zona hospedada e a API usando a mesma AWS conta ou contas diferentes:
-
Mesma conta — A lista de nomes de domínio de destino inclui somente APIs aqueles com um nome de domínio personalizado que corresponda ao valor que você especificou para Nome do registro. Selecione o valor aplicável.
-
Different accounts (Diferentes contas): insira o valor que você obteve na etapa 1 deste procedimento.
- Tipo de registro
-
Escolha A — IPv4 endereço.
- Avaliar status do alvo
-
Para controlar o failover de DNS, configure verificações de integridade personalizadas. Para ver um exemplo, consulte Configurar verificações de integridade personalizadas para failover de DNS no Guia do usuário do API Gateway.
-
Escolha Criar registros.
As alterações geralmente são propagadas para todos os servidores do Route 53 dentro de 60 segundos. Quando a propagação for concluída, você poderá rotear o tráfego para sua API usando o nome do registro de alias que você criou neste procedimento.
- Custom domain names for private APIs
-
O procedimento a seguir descreve como rotear o tráfego para um endpoint do API Gateway para obter um nome de domínio personalizado para uso privado APIs.
Para encaminhar o tráfego para um endpoint do API Gateway
Abra o console do Route 53 em https://console.aws.amazon.com/route53/.
No painel de navegação, escolha Zonas hospedadas.
Escolha o nome da zona hospedada privada que tem o nome de domínio que você deseja usar para rotear o tráfego para sua API.
Escolha Create record (Criar registro).
Especifique os seguintes valores:
- Política de roteamento
-
Selecione a política de roteamento aplicável. Para obter mais informações, consulte Escolher uma política de roteamento.
- Nome de registro
-
Insira o nome de domínio que você deseja usar para rotear o tráfego para sua API.
A API para a qual você deseja encaminhar o tráfego deve incluir um nome de domínio personalizado, como api.example.com que corresponda ao nome do registro do Route 53.
- Alias
-
Ative o Alias.
- Valor/Encaminhar tráfego para
-
Escolha um alias para o VPC Endpoint. Escolha a região de origem do endpoint e, em seguida, selecione seu VPC endpoint.
- Tipo de registro
-
Se você estiver usando IPv6 para seu VPC endpoint, crie um tipo de registro AAAA. Se estiver usando pilha dupla para o endpoint da VPC, crie um registro do tipo AAAA e um do tipo A.
- Avaliar status do alvo
-
Para controlar o failover de DNS, configure verificações de integridade personalizadas. Para ver um exemplo, consulte Configurar verificações de integridade personalizadas para failover de DNS no Guia do usuário do API Gateway.
-
Escolha Criar registros.
As alterações geralmente são propagadas para todos os servidores do Route 53 dentro de 60 segundos. Quando a propagação for concluída, você poderá rotear o tráfego para sua API usando o nome do registro de alias que você criou neste procedimento.
