Como faço para criar uma integração privada com um Application Load Balancer interno para uma API HTTP do API Gateway?

Resolução

Observação: se você receber erros ao executar comandos da AWS Command Line Interface (AWS CLI), consulte Solução de problemas da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.

Crie o link da VPC

Pré-requisito: Criar um Application Load Balancer.

É possível usar o console do API Gateway ou a AWS CLI para criar o link da VPC.

Console do API Gateway

Conclua as etapas a seguir:

1. Abra o console do API Gateway.
2. No painel de navegação, selecione Links da VPC e clique em Criar.
3. Em Escolher uma versão do link da VPC, selecione Link da VPC para APIs HTTP.
4. Em Nome, insira um nome para o seu link da VPC.
5. Na lista suspensa VPC, selecione uma VPC à qual seu Application Load Balancer se conecta.
6. Em Sub-redes, selecione suas sub-redes para incluir no link da VPC.
7. Em Grupos de segurança, selecione os grupos de segurança para o link da VPC e, em seguida, clique em Criar.

AWS CLI

Execute o seguinte comando create-vpc-link:

aws apigatewayv2 create-vpc-link --name MyVpcLink \      --subnet-ids subnet-aaaa subnet-bbbb \  
    --security-group-ids sg1234 sg5678

Crie uma API HTTP e roteie

Conclua as seguintes etapas:

1. Abra o console do API Gateway.
2. Escolha Criar API.
3. Para API HTTP, escolha Criar.
4. Em Nome da API, insira um nome e escolha Próximo.
5. Em Configurar rotas, escolha Próximo.
6. Em Configurar estágios, escolha Próximo e, em seguida, escolha Criar.
7. No painel de navegação, escolha Rotas e depois Criar.
8. Em Método, escolha QUALQUER.
9. Em caminho, insira /{proxy+} e escolha Criar.

Crie uma integração privada e implante a API HTTP

Conclua as seguintes etapas:

1. Abra o console do API Gateway.
2. Selecione sua API HTTP.
3. No painel de navegação, selecione Integrações.
4. Em Integrações, escolha Gerenciar integrações e, em seguida, escolha Criar.
5. Para Anexar essa integração a uma rota, escolha QUALQUER/{proxy+}.
6. Em Destino de integração, escolha Recurso privado.
7. Para obter Detalhes da integração, escolha Selecionar manualmente.
8. Em Serviço de destino, escolha ALB/NLB.
9. Em Balanceador de carga, selecione seu Application Load Balancer.
10. Em Receptor, selecione HTTP 80.
11. Em Link da VPC, escolha sua VPC e, em seguida, clique em Criar.
12. Se você não ativou a Implantação automática, selecione Implantar.
13. Em Invocar URL, anote o URL e insira-o em uma nova janela do navegador. Um exemplo de URL é https://abcdef123.execute-api.us-east-1.amazonaws.com.

Observação: o tráfego de integração privada usa o protocolo HTTP. Se você precisar de tráfego de integração privada para usar HTTPS, use o Console de Gerenciamento da AWS para especificar um TlsConfig. Ao criar sua integração privada, selecione Configurações avançadas e insira um nome de servidor seguro. Para obter mais informações, consulte Criar integrações privadas para APIs HTTP no API Gateway.

Informações relacionadas

Tutoriais da API HTTP do Amazon API Gateway

How do I map the response status codes for API Gateway integrations in HTTP APIs?