Como posso encaminhar o cabeçalho do host com integração privada para uma API REST do API Gateway?

Breve descrição

O Amazon API Gateway substitui o valor do host que recebe na solicitação original para o endpoint de integração. Dependendo da URL do endpoint da solicitação de integração, o Amazon API Gateway atribui o valor do host.

Para usar o valor do cabeçalho do host de um endpoint do API Gateway no backend, use o cabeçalho personalizado. Use o cabeçalho personalizado na solicitação de integração que contém o valor do cabeçalho do host da solicitação.

Resolução

Criar uma API REST do API Gateway

1.    Abra o console do API Gateway.

2.    Escolha Criar API.

-ou-

Se for a primeira vez que você usa o API Gateway, uma página que apresenta o serviço será exibida. Em API REST, selecione Criar. Quando a janela pop-up Criar exemplo de API aparecer, escolha OK.

3.    Em Escolher um tipo de API, no painel API REST, escolha Criar.

4.    Em Criar nova API, selecione Nova API.

5.    Em Configurações, insira estes valores:
Em Nome da API, insira um nome que descreva a finalidade da sua API. Por exemplo: ForwardHostHeader.
(Opcional) Em Descrição, insira uma breve descrição da finalidade da sua API. Por exemplo, Encaminhar o cabeçalho do host para integração privada.
Em Tipo de endpoint, escolha Regional, Otimizado para borda ou ** Privado**.

6.    Escolha Criar API.

Configurar a solicitação de método e a solicitação de integração da sua API

1.    Abra o console do API Gateway.

2.    Siga as instruções para criar uma API com integração privada usando o console do API Gateway.

3.    Em Solicitação de método, adicione **Cabeçalhos de solicitação HTTP ** como host.

4.    Em Solicitação de integração, expanda Cabeçalhos HTTP e escolha Adicionar cabeçalho.

5.    Insira um nome para o cabeçalho personalizado. Por exemplo, my_host.

6.    Em Mapeado de, insira a solicitação do método. Por exemplo, method.request.header.host. Em seguida, selecione o ícone de marca de seleção.

Implantar sua API em um novo estágio

1.    Abra o console do API Gateway.

2.    Siga as instruções para Implantar uma API REST em um estágio. Para obter mais informações, consulte Configurar um estágio usando o console do API Gateway.

3.    No painel Editor de estágios, copie a URL de invocação para a área de transferência. Use esse URL para invocar sua API.

Exemplo de URL de invocação da API REST:

https://1a2bc3d456.execute-api.us-east-1.amazonaws.com/stage

4.    Se você usa um Application Load Balancer para seu backend, adicione uma regra para testar sua configuração. Escolha "cabeçalho http" como condição e, em seguida, especifique "my_host" como o mesmo cabeçalho e valor do host do API Gateway.

5.    Cole o URL do API Gateway em uma janela do navegador para invocar sua API. A configuração do cabeçalho "my_host" no API Gateway encaminha o valor do host do API Gateway para o Application Load Balancer. O Application Load Balancer corresponde à condição definida e, em seguida, retorna a resposta como configurada.

Informações relacionadas

Configurar mapeamentos de dados de solicitação e resposta usando o console do API Gateway

Configurar uma API usando o console do API Gateway

Notas importantes do Amazon API Gateway

Como integrar uma API REST do API Gateway a um Application Load Balancer?