Comment créer une intégration privée avec un Application Load Balancer interne pour une API HTTP API Gateway ?

Résolution

Remarque : si des erreurs surviennent lorsque vous exécutez des commandes de l’interface de la ligne de commande AWS (AWS CLI), consultez la page Résoudre les erreurs liées à AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l’AWS CLI.

Pour créer une intégration privée avec un Application Load Balancer interne pour une API HTTP API Gateway, procédez comme suit :

1. Créez un lien Amazon Virtual Private Cloud (Amazon VPC).
2. Créez une route et une API HTTP.
3. Créez une intégration privée.
4. Déployez l'API HTTP.

Création du lien VPC

Prérequis : Créez un Application Load Balancer.

Procédez comme suit :

1. Ouvrez la console API Gateway.

2. Dans le volet de navigation, choisissez Liens VPC.

3. Dans Liens VPC, choisissez Créer.
   Vous pouvez également créer un lien VPC depuis l'AWS CLI à l'aide de la commande create-vpc-link :

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

4. Dans Choisir une version de lien VPC, choisissez Lien VPC pour les API HTTP.

5. Dans le champ Nom, saisissez le nom de votre lien VPC.

6. Dans la liste déroulante VPC, choisissez un VPC auquel vous souhaitez connecter votre Application Load Balancer.

7. Dans Sous-réseaux, choisissez les sous-réseaux à inclure dans le lien VPC.

8. Dans Groupes de sécurité, choisissez les groupes de sécurité pour le lien VPC, puis choisissez l’option Créer.

Création d’une route et d'une API HTTP

Procédez comme suit :

1. Ouvrez la console API Gateway.
2. Sélectionnez Créer une API.
3. Dans API HTTP, choisissez Création.
4. Saisissez un nom dans le champ Nom d’API, puis sélectionnez Suivant.
5. Dans Configurer des routes, choisissez Suivant.
6. Dans Configurer les étapes, choisissez Suivant, puis Créer.
7. Dans le volet de navigation, choisissez Routes, puis Créer.
8. Dans Méthode, choisissez ANY.
9. Dans le chemin, saisissez /{proxy+}, puis Créer.

Création d’une intégration privée et déploiement de l'API HTTP

Procédez comme suit :

1. Ouvrez la console API Gateway.
2. Choisissez votre API HTTP.
3. Dans le volet de navigation, choisissez Intégrations.
4. Dans Intégrations, choisissez Gérer les intégrations, puis Créer.
5. Dans Joindre cette intégration à une route, choisissez ANY /{proxy+}.
6. Dans Cible d'intégration, choisissez Ressource privée.
7. Dans Détails de l'intégration, choisissez Sélectionner manuellement.
8. Dans Service cible, choisissez ALB/NLB.
9. Dans Équilibreur de charge, choisissez l'Application Load Balancer que vous avez déjà créé.
10. Dans Écouteur, choisissez HTTP 80.
11. Dans Lien VPC, choisissez votre VPC, puis Créer.
12. (Cette étape peut être ignorée si le déploiement automatique est actif) Choisissez Déployer pour déployer votre API HTTP.
13. Dans Appeler une URL, copiez l'URL et collez-la dans une nouvelle fenêtre de navigateur. Exemple : https://abcdef123.execute-api.us-east-1.amazonaws.com.

L'URL de l'API HTTP s'affiche correctement dans la fenêtre du navigateur.

Informations connexes

Didacticiels sur l'API HTTP Amazon API Gateway

Comment mapper les codes d'état de réponse pour les intégrations API Gateway dans les API HTTP ?