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 les périphériques, régional ou privé, en fonction de l'emplacement duquel provient la majorité de votre trafic d'API.

Points de terminaison d'API optimisées pour les périphériques

Un point de terminaison d'API optimisé pour les périphériques achemine généralement les demandes vers le CloudFront point de présence (POP) le plus proche, ce qui peut être utile dans les cas où vos clients sont répartis 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 les périphériques utilisent une lettre majuscule pour les noms des en-têtes HTTP (par exemple, Cookie).

CloudFront trie les cookies HTTP dans l'ordre naturel par nom de cookie avant de transmettre la demande à votre source. Pour plus d'informations sur la manière dont les cookies CloudFront sont traités, consultez la section Mise en cache du contenu basé sur les cookies.

Un nom de domaine personnalisé que vous utilisez pour une API optimisée pour les périphériques s'applique à toutes les régions.

Points de terminaison d'API régionale

Un point de terminaison d'API régional est destiné aux clients de la même région. Lorsqu'un client exécuté sur une instance EC2 appelle une API dans la même région, ou lorsqu'une API est destinée à servir un petit nombre de clients ayant des exigences élevées, une API régionale réduit la charge de connexion.

Pour une API régionale, tout 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 de plus amples informations, veuillez consulter Configurer un nom de domaine personnalisé régional dans API Gateway et Configurer un nom de domaine personnalisé optimisé pour les périphériques dans Gateway API.

Les points de terminaison d'API régionale transmettent tous les noms d'en-tête en l'état.

Note

Dans les cas où les clients d'API sont géographiquement dispersés, il peut toujours être judicieux d'utiliser un point de terminaison d'API régional, associé à votre propre CloudFront distribution Amazon, afin de garantir qu'API Gateway n'associe pas l'API à des distributions contrôlées par les services CloudFront . Pour plus d'informations sur ce cas d'utilisation, consultez Comment configurer API Gateway avec ma propre CloudFront distribution ? .

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 de plus amples informations, veuillez consulter Privé REST APIs dans API Gateway.

Les points de terminaison d’API privée transmettent tous les noms d'en-tête à travers en l'état.