Configuration de l'intégration de proxy avec une ressource de proxy - Amazon API Gateway

Configuration de l'intégration de proxy avec une ressource de proxy

Pour configurer une intégration de proxy dans une API API Gateway avec une ressource de proxy, exécutez les tâches suivantes :

  • Créer une ressource de proxy avec une variable de chemin gourmande {proxy+}.

  • Définir la méthode ANY sur la ressource de proxy.

  • Intégrer la ressource et la méthode à un serveur principal à l'aide du type d'intégration HTTP ou Lambda.

Note

Les variables de chemin gourmandes en ressources, les méthodes ANY et les types d'intégration de proxy sont des fonctions indépendantes, même si elles sont couramment utilisées ensemble. Vous pouvez configurer une méthode spécifique HTTP sur une ressource gourmande ou appliquer des types d'intégration différente de proxy à une ressource de proxy.

API Gateway adopte certaines restrictions et limitations lors de la gestion des méthodes avec une intégration de proxy Lambda ou une intégration de proxy HTTP. Pour plus d'informations, consultez Remarques importantes sur Amazon API Gateway.

Note

Lorsque vous utilisez l'intégration de proxy avec une transmission, API Gateway renvoie l'en-tête Content-Type:application/json par défaut si le type de contenu d'une charge utile n'est pas spécifié.

Une ressource de proxy est plus puissante lorsqu'elle est intégrée à un backend à l'aide de l'intégration de proxy HTTP ou de l'intégration de proxy Lambda.

Intégration de proxy HTTP avec une ressource de proxy

L'intégration de proxy HTTP, désignée par HTTP_PROXY dans l'API REST API Gateway, est utilisée pour l'intégration d'une requête de méthode avec un point de terminaison HTTP du backend. Avec ce type d'intégration, API Gateway passe simplement l'intégralité de la requête et de la réponse entre le serveur frontal et le backend, avec certaines restrictions et limitations.

Note

L'intégration de proxy HTTP prend en charge les en-têtes à valeurs multiples et les chaînes de requête.

Lors de l'application de l'intégration de proxy HTTP à une ressource du proxy, vous pouvez configurer votre API de façon à exposer tout ou partie de la hiérarchie des points de terminaison du serveur principal HTTP avec une configuration d'intégration unique. Par exemple, supposons que le site web de votre serveur principal est organisé en plusieurs branches de nœuds d'arborescence éloignées du nœud racine (/site) comme : /site/a0/a1/.../aN, /site/b0/b1/.../bM, etc. Si vous intégrez la méthode ANY sur une ressource de proxy /api/{proxy+} aux points de terminaison du backend avec des chemins d'URL /site/{proxy}, une demande d'intégration unique peut prendre en charge n'importe quelle opération HTTP (GET, POST, etc.) sur [a0, a1, ..., aN, b0, b1, ...bM, ...]. Si vous appliquez une intégration de proxy à une méthode HTTP spécifique, par exemple, GET, à la place, la demande d'intégration qui en résulte fonctionne avec les opérations (par exemple, GET) spécifiées sur n'importe lequel de ces nœuds du serveur principal.

Intégration de proxy Lambda avec une ressource de proxy

L'intégration de proxy Lambda, désignée par AWS_PROXY dans l'API REST API Gateway, est utilisée pour l'intégration d'une demande de méthode avec une fonction Lambda sur le backend. Avec ce type d'intégration, API Gateway applique un modèle de mappage par défaut pour envoyer l'ensemble de la demande à la fonction Lambda et transforme la sortie de la fonction Lambda en réponses HTTP.

De même, vous pouvez appliquer l'intégration de proxy Lambda à une ressource de proxy /api/{proxy+} afin de configurer une intégration unique pour qu'une fonction Lambda du backend réagisse individuellement aux modifications des ressources d'API sous /api.