Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Envoyez du trafic vers vous APIs via votre nom de domaine personnalisé dans API Gateway
Lorsque vous configurez le mode de routage pour votre nom de domaine personnalisé, vous définissez la manière dont le trafic entrant est dirigé vers votre APIs. Vous envoyez du trafic à votre adresse à APIs l'aide de règles de routage, de mappages d'API ou de règles de routage et de mappages d'API. La section suivante explique quand utiliser les règles de routage, quand utiliser les mappages d'API et comment définir le mode de routage pour votre nom de domaine personnalisé.
Quand utiliser les règles de routage
Lorsque vous utilisez des règles de routage, vous dirigez les demandes entrantes qui répondent à certaines conditions vers des APIs étapes REST spécifiques. Par exemple, une règle peut acheminer une demande vers l'productionétape de votre users API REST si elle contient l'en-tête version:v1 et le chemin de base/users. Utilisez les règles de routage pour créer des topologies de routage dynamiques avancées qui prennent en charge des cas d'utilisation tels que le A/B test ou l'augmentation de l'utilisation des nouvelles versions de votre APIs.
Lorsque vous dirigez 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 de plus amples informations, veuillez consulter Recréez un mappage d'API à l'aide de règles de routage.
Pour REST APIs, vous pouvez également utiliser conjointement des règles de routage et des mappages d'API. Lorsque vous utilisez des règles de routage et des mappages d'API ensemble, API Gateway évalue toujours les règles de routage avant d'évaluer les mappages d'API. Utilisez conjointement les règles de routage et les 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 :
-
WebSocket ou le protocole HTTP APIs ne sont pas pris en charge comme cible APIs pour les règles de routage.
-
Si votre nom de domaine personnalisé comporte des mappages d'API à la fois vers REST et HTTP APIs, les règles de routage ne sont pas prises en charge.
-
Vous pouvez créer une règle de routage pour un domaine personnalisé privé vers une API REST privée. Vous pouvez créer une règle de routage pour un domaine public personnalisé vers une API régionale ou optimisée pour les périphériques.
-
Vous ne pouvez pas créer de règle de routage pour un domaine public personnalisé vers une API privée. Vous ne pouvez pas créer de règle de routage pour un nom de domaine personnalisé privé vers une API publique.
Choisissez entre les règles de routage et les mappages d'API
Nous vous recommandons d'utiliser des règles de routage dans la mesure du possible. Utilisez uniquement les mappages d'API pour envoyer du trafic vers un HTTP ou une WebSocket API.
