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 mensagens de erro 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: crie 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 etapas a seguir:

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

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

Conclua as etapas a seguir:

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, selecione Gerenciar integrações e, em seguida, clique em Criar.
5. Em Anexar essa integração a uma rota, selecione QUALQUER /{proxy+}.
6. Em Destino de integração, clique em Recurso privado.
7. Em Detalhes da integração, clique em Selecionar manualmente.
8. Em Serviço de destino, selecione ALB/NLB.
9. Em Balanceador de carga, selecione seu Application Load Balancer.
10. Em Receptor, selecione HTTP 80.
11. Em Link da VPC, selecione 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? (Como mapear os códigos de status de resposta para integrações do API Gateway em APIs HTTP?)