Le test de connectivité pour l'autorisation d'accès VPC vérifie la connectivité réseau entre une instance API Gateway et une instance backend située dans votre VPC autorisé. Cette opération vous aide à identifier rapidement les échecs d'appel liés à la connectivité dès la phase de débogage de l'API.
Autorisation d'accès VPC
Une autorisation d'accès VPC est un enregistrement qui permet à API Gateway d'accéder aux services backend déployés dans votre VPC. Pour en créer une, indiquez l'ID de votre VPC, l'ID de l'instance CLB ou ECS qui héberge le service, ainsi que le numéro de port du service. Ces valeurs identifient conjointement un service backend de manière unique et autorisent API Gateway à y accéder. Pour plus d'informations, consultez la rubrique Utiliser une ressource dans un VPC comme backend d'API.
Test de connectivité
Connectez-vous à la console API Gateway. Dans le volet de navigation de gauche, sélectionnez , puis créez une autorisation d'accès VPC.
-
Cliquez sur Test Connectivity et sélectionnez l'instance API Gateway cible.
ImportantAssurez-vous qu'aucune politique de contrôle d'accès n'est configurée sur l'instance sélectionnée. Dans le cas contraire, le test de connectivité pourrait échouer.
-
Cliquez sur Test. Une sonde réseau est envoyée depuis l'instance API Gateway sélectionnée vers le service backend spécifié dans l'autorisation d'accès VPC. Une fois le test terminé, consultez le résultat sur la page actuelle.
-
Test réussi
Une coche verte à gauche de la liste déroulante des instances indique que la connexion réseau est établie et que le test de connectivité a réussi.
Cette fonctionnalité est disponible uniquement pour les versions d'instance de gateway 3.5.3.791 et ultérieures. Si la fonctionnalité n'est pas disponible, vérifiez la version de votre instance ou contactez-nous pour demander une mise à niveau.
-
Échec du test
Un échec du test de connectivité affiche généralement un message indiquant que la connexion réseau entre l'instance API Gateway et le service défini dans votre autorisation d'accès VPC n'a pas pu être établie. En cas d'échec, cliquez sur le lien Guide de dépannage et suivez les instructions pour résoudre le problème.
Une icône d'erreur rouge (×) apparaît à gauche du champ Instance dans la boîte de dialogue du test de connectivité, signalant une défaillance réseau.
-
Dépannage
Si le test de connectivité échoue, cliquez sur Guide de dépannage pour ouvrir une boîte de dialogue qui vous guide étape par étape vers la résolution du problème. Le contenu de cette boîte de dialogue varie selon le type d'instance (CLB ou ECS) spécifié dans votre autorisation d'accès VPC.
Le processus de dépannage comprend trois étapes principales :
-
Vérifiez les informations relatives à l'autorisation d'accès VPC.
Lors de la création d'une autorisation d'accès VPC, vous devez spécifier l'ID du VPC, l'ID de l'instance et le numéro de port du service. À cette étape, accédez à la console du service cloud correspondant pour vérifier l'exactitude des informations saisies.
Vérification de l'ID du VPC : connectez-vous à la console VPC. Dans le volet de navigation de gauche, cliquez sur VPC. Repérez l'ID du VPC cible dans la liste des instances. Vérification de l'ID de l'instance : connectez-vous à la console ECS. Dans le volet de navigation de gauche, cliquez sur Instances. Repérez l'ID de l'instance ECS cible dans la liste des instances. Vérification du numéro de port du service : assurez-vous que le port d'écoute du service backend correspond au numéro de port indiqué dans l'autorisation d'accès VPC.
-
Vérifiez le groupe de sécurité de l'instance ECS ou les listes d'autorisation et de blocage de l'instance CLB.
Si votre autorisation d'accès VPC pointe vers une instance ECS disposant d'un groupe de sécurité configuré, ajoutez l'adresse IP sortante de l'instance API Gateway aux règles entrantes du groupe de sécurité.
Si votre autorisation d'accès VPC pointe vers une instance CLB utilisant une politique de contrôle d'accès basée sur une liste d'autorisation, ajoutez l'adresse IP sortante de l'instance API Gateway aux entrées d'adresse du groupe de politiques de contrôle d'accès correspondant.
-
Vérifiez l'état d'exécution du service backend.
À cette étape, examinez l'état d'exécution et l'intégrité du service backend. Si l'instance spécifiée dans l'autorisation d'accès VPC est une instance ECS, vérifiez son état de santé. S'il s'agit d'une instance CLB, vérifiez l'état d'exécution de l'écouteur configuré et assurez-vous que les tests d'intégrité sont réussis. Pour valider le port, connectez-vous à n'importe quel serveur de votre VPC et exécutez la commande curl afin de vérifier si le port spécifié sur l'instance ECS ou CLB est en écoute.