Encaminhar o tráfego para uma API do Amazon API Gateway por meio do seu nome de domínio

É possível usar o Amazon API Gateway para criar, publicar, manter, monitorar e proteger APIs. Você pode criar APIs que acessam serviços da AWS ou outros serviços Web, além de dados armazenados na Nuvem AWS.

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.

• 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 distribuição do CloudFront que está associada à API otimizada para borda.

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.

nota

O Route 53 não cobra por consultas de alias para APIs do API Gateway nem para outros recursos da AWS.

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:

  • Configurar nomes de domínio personalizados para APIs HTTP no Guia do desenvolvedor do Amazon API Gateway.

  • Configurar nomes de domínio personalizados para APIs REST no Guia do desenvolvedor do Amazon API Gateway.

  • Configurar nomes de domínio personalizados paraWebSocket APIs no Guia do desenvolvedor do Amazon API Gateway.

• 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.

Para encaminhar o tráfego para um endpoint do API Gateway

1. 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:

   1. Faça login no AWS Management Console e abra o console do API Gateway em https://console.aws.amazon.com/apigateway/.

   2. No painel de navegação, selecione Custom domain names (Nomes de domínio personalizados).

   3. 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).

2. Abra o console do Route 53 em https://console.aws.amazon.com/route53/.

3. No painel de navegação, escolha Zonas hospedadas.

4. Selecione o nome da zona hospedada com o nome de domínio que você deseja usar para rotear o tráfego para sua API.

5. Escolha Create record (Criar registro).

6. 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

   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 maneira como você especifica o valor do Endpoint depende se você criou a zona hospedada e a API usando a mesma conta da AWSou contas diferentes:

   • Same account (Mesma conta): a lista de nomes de domínio de destino inclui apenas as APIs que têm um nome de domínio personalizado que corresponde ao valor que você especificou em Record name (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 address (A – Endereço IPv4).

   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.

7. Escolha Create records (Criar registros).

   As alterações geralmente são propagadas para todos os servidores do Route 53 dentro de 53 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.