Envoi du trafic à vos API via votre nom de domaine personnalisé dans API Gateway
Lorsque vous configurez le mode de routage de votre nom de domaine personnalisé, vous définissez la méthode d’acheminement du trafic entrant vers vos API. Vous envoyez le trafic à vos API à l’aide de règles de routage, de mappages d’API ou des deux. La section suivante explique quand utiliser des règles de routage et des mappages d’API, et comment définir le mode de routage de votre nom de domaine personnalisé.
Quand utiliser des règles de routage
Lorsque vous utilisez des règles de routage, vous acheminez les demandes entrantes qui répondent à certaines conditions vers des étapes spécifiques de votre API REST. Par exemple, une règle peut acheminer une demande vers l’étape production de votre API REST users si elle contient l’en-tête version:v1 et le chemin de base /users. Utilisez des règles de routage pour créer des topologies de routage dynamiques avancées qui prennent en charge des cas d’utilisation tels que les tests A/B ou l’utilisation croissante des nouvelles versions de vos API.
Lorsque vous acheminez le trafic vers une API REST, nous vous recommandons d’utiliser des règles de routage pour votre nom de domaine personnalisé. Vous pouvez recréer n’importe quel mappage d’API à l’aide de règles de routage. Pour plus d’informations, consultez Recréation d’un mappage d’API à l’aide de règles de routage.
Pour les API REST, vous pouvez également utiliser conjointement des règles de routage et des mappages d’API. Le cas échéant, API Gateway évalue toujours les règles de routage avant les mappages d’API. Utilisez conjointement des règles de routage et des mappages d’API pour migrer vos noms de domaine personnalisés actuels ou pour explorer les règles de routage.
Considérations relatives aux règles de routage
Les considérations suivantes peuvent avoir un impact sur votre utilisation des règles de routage :
-
Les règles de routage ne prennent pas en charge les API WebSocket et HTTP en tant qu’API cibles.
-
Si votre nom de domaine personnalisé comporte des mappages d’API à des API REST et HTTP, les règles de routage ne sont pas prises en charge.
-
Pour un domaine personnalisé privé, vous pouvez créer une règle de routage vers une API REST privée. Pour un domaine public personnalisé, vous pouvez créer une règle de routage vers une API régionale ou optimisée pour la périphérie.
-
Pour un domaine personnalisé privé, vous ne pouvez pas créer de règle de routage vers une API privée. Pour un nom de domaine personnalisé privé, vous ne pouvez pas créer de règle de routage vers une API publique.
Choix entre les règles de routage et les mappages d’API
Nous vous recommandons d’utiliser les règles de routage dans la mesure du possible. Utilisez uniquement les mappages d’API pour envoyer le trafic à une API HTTP ou WebSocket.
