Types de points de terminaison d’API pour les API REST dans API Gateway
Un type de point de terminaison d’API fait référence au nom d’hôte de l’API. Le type de point de terminaison de l’API peut être optimisé pour la périphérie, régional ou privé, en fonction de l’emplacement duquel provient la majorité de votre trafic d’API.
Points de terminaison d’API optimisés pour la périphérie
Un point de terminaison d’API optimisé pour la périphérie achemine généralement les demandes vers le point de présence (POP) CloudFront le plus proche, ce qui peut être utile lorsque vos clients sont dispersés géographiquement. Il s’agit du type de point de terminaison par défaut pour les API REST API Gateway.
Les API optimisées pour la périphérie utilisent une lettre majuscule pour les noms des en-têtes HTTPCookie).
CloudFront trie les cookies HTTP en ordre naturel par nom de cookie avant de transmette la demande à votre origine. Pour plus d’informations sur la façon dont CloudFront traite les cookies, consultez Mise en cache basée sur les cookies.
Un nom de domaine personnalisé que vous utilisez pour une API optimisée pour la périphérie s’applique à toutes les régions.
Points de terminaison d’API régionale
Un point de terminaison d’API régionale est conçu pour les clients situés dans la même région. Lorsqu’un client s’exécutant sur une instance EC2 appelle une API de la même région, ou lorsqu’une API est destinée à servir un petit nombre de clients aux demandes très exigeantes, une API régionale réduit la surcharge de connexion.
Pour une API régionale, le nom de domaine personnalisé que vous utilisez est spécifique à la région où l’API est déployée. Si vous déployez une API régionale dans plusieurs régions, elle pourra avoir le même nom de domaine personnalisé dans toutes les régions. Vous pouvez utiliser des domaines personnalisés avec Amazon Route 53 pour effectuer des tâches telles que le routage basé sur la latence. Pour plus d’informations, consultez Configuration d’un nom de domaine personnalisé régional dans API Gateway et Configuration d’un nom de domaine personnalisé optimisé pour la périphérie dans API Gateway.
Les points de terminaison d’API régionale transmettent tous les noms d’en-tête en l’état.
Note
Si les clients d’API sont dispersés géographiquement, il peut s’avérer judicieux malgré tout d’utiliser un point de terminaison d’API régional avec votre propre distribution Amazon CloudFront afin de s’assurer qu’API Gateway n’associe pas l’API aux distributions CloudFront contrôlées par le service. Pour plus d’informations sur ce cas d’utilisation, consultez Comment configurer API Gateway avec ma propre distribution CloudFront ?
Point de terminaison d’API privée
Un point de terminaison d’API privée est un point de terminaison d’API qui est uniquement accessible à partir de votre Amazon Virtual Private Cloud (VPC) à l’aide d’un point de terminaison d’un VPC d’interface, qui est une interface réseau de point de terminaison (ENI) créée dans votre VPC. Pour plus d’informations, consultez API REST privées dans API Gateway.
Les points de terminaison d’API privée transmettent tous les noms d’en-tête à travers en l’état.
