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.
Acheminer le trafic vers une API Amazon API Gateway à l'aide de votre nom de domaine
Vous pouvez utiliser Amazon API Gateway pour créer, publier, gérer, surveiller et sécuriser APIs. Vous pouvez créer APIs ces AWS services d'accès ou d'autres services Web en plus des données stockées dans le AWS Cloud.
La méthode que vous utilisez pour acheminer le trafic du domaine vers une API API Gateway est la même, que vous ayez créé un point de terminaison API Gateway régional ou un point de terminaison API Gateway optimisé pour les périphériques. Si vous créez un point de terminaison API Gateway privé, le processus est légèrement différent.
Point de terminaison d'API régional : vous créez un enregistrement d'alias Route 53 qui achemine le trafic vers le point de terminaison d'API régional.
Point de terminaison d'API optimisé pour les périphériques : vous créez un enregistrement d'alias Route 53 qui achemine le trafic vers l'API optimisée pour les périphériques. Cela entraîne le routage du trafic vers la CloudFront distribution associée à l'API optimisée pour les périphériques.
-
Point de terminaison d'API privé : vous créez un enregistrement d'alias Route 53 qui achemine le trafic vers votre point de terminaison d'API privé à l'aide d'un point de terminaison VPC d'interface pour API Gateway dans une zone hébergée privée.
Un enregistrement d'alias est une extension Route 53 de DNS similaire à un enregistrement CNAME. Pour plus d'informations sur la comparaison entre des enregistrements d'alias et des enregistrements CNAME, veuillez consulter Choix entre des enregistrements avec ou sans alias.
Route 53 ne facture pas les requêtes d'alias adressées à API Gateway APIs ou à d'autres AWS ressources.
Prérequis
Pour commencer, vous. devez disposer des éléments suivants :
Une API API Gateway qui possède un nom de domaine personnalisé, comme api.example.com, qui correspond au nom de l'enregistrement Route 53 que vous souhaitez créer.
Pour plus d’informations, consultez les rubriques suivantes :
Un nom de domaine enregistré. Vous pouvez utiliser Amazon Route 53 en tant que bureau d'enregistrement de domaine, ou vous pouvez utiliser un autre bureau d'enregistrement.
Route 53 en tant que service DNS pour le domaine. Si vous enregistrez votre nom de domaine à l'aide de Route 53, nous configurons automatiquement Route 53 en tant que service DNS pour le domaine.
Pour en savoir plus sur l'utilisation de Route 53 comme fournisseur de service DNS pour votre domaine, consultez Configuration d'Amazon Route 53 en tant que service DNS d'un domaine existant.
Configuration de Route 53 pour acheminer le trafic vers un point de terminaison API Gateway
Pour configurer Route 53 pour acheminer le trafic vers un point de terminaison API Gateway, exécutez la procédure suivante.
- Custom domain names for public APIs
-
La procédure suivante décrit comment acheminer le trafic vers un point de terminaison API Gateway pour un nom de domaine personnalisé destiné au public APIs.
Pour acheminer le trafic vers un point de terminaison API Gateway
Si vous avez créé la zone hébergée Route 53 et le point de terminaison à l'aide du même compte, passez à l'étape 2.
Si vous avez créé la zone hébergée et le point de terminaison à l'aide de différents comptes, obtenez le nom de domaine cible pour le nom de domaine personnalisé que vous souhaitez utiliser :
Connectez-vous à la console API Gateway AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/apigateway/.
Dans le panneau de navigation, sélectionnez Custom domain names (Noms de domaine personnalisés).
Sélectionnez le nom de domaine personnalisé que vous souhaitez utiliser et obtenez la valeur du nom de domaine de l'API Gateway.
Ouvrez la console Route 53 à l'adresse https://console.aws.amazon.com/route53/.
Dans le panneau de navigation, choisissez Zones hébergées.
Choisissez le nom de la zone hébergée qui a le nom de domaine que vous souhaitez utiliser pour acheminer le trafic vers votre API.
Choisissez Créer un registre.
Indiquez l’une des valeurs suivantes :
Nous vous recommandons d'activer Alias. Pour les noms de domaine qui n'utilisent pas d'enregistrement Route 53 Alias, vous pouvez rencontrer des problèmes si vous utilisez un VPC avec un DNS privé activé pour appeler une API privée. Le DNS privé remplace le comportement de résolution DNS par défaut au sein du VPC, ce qui peut entraîner des conflits avec les enregistrements DNS externes.
- Stratégie de routage
-
Choisissez la stratégie de routage applicable. Pour de plus amples informations, veuillez consulter Sélection d'une stratégie de routage.
- Nom de l'enregistrement
-
Entrez le nom de domaine que vous souhaitez utiliser pour acheminer le trafic vers votre API.
L'API vers laquelle vous souhaitez acheminer le trafic doit inclure un nom de domaine personnalisé, comme api.example.com, qui correspond au nom de l'enregistrement Route 53.
- Alias
-
Si vous utilisez la méthode de création d'enregistrement Quick create (Création rapide), activez Alias.
- Valeur/acheminer le trafic vers
-
Choisissez Alias to API Gateway API (Alias vers API API Gateway), puis choisissez la région d'origine du point de terminaison.
La façon dont vous spécifiez la valeur pour Endpoint varie selon que vous avez créé la zone hébergée et l'API en utilisant le même AWS compte ou des comptes différents :
-
Même compte — La liste des noms de domaine cibles inclut uniquement ceux APIs dont le nom de domaine personnalisé correspond à la valeur que vous avez spécifiée pour le nom de l'enregistrement. Choisissez la valeur applicable.
-
Différents comptes : entrez la valeur que vous avez obtenue à l'étape 1 de cette procédure.
- Type de registre
-
Choisissez A — IPv4 adresse.
- Évaluer l'état de la cible
-
Pour contrôler le basculement DNS, configurez des surveillances de l'état personnalisés. Par exemple, consultez Configurer des surveillances de l'état personnalisés pour le basculement DNS dans le guide de l'utilisateur d'API Gateway.
-
Choisissez Créer des enregistrements.
Les changements se propagent généralement sur tous les serveurs Route 53 en 60 secondes. Lorsque la propagation est terminée, vous pourrez acheminer le trafic vers votre API en utilisant le nom de l'enregistrement d'alias que vous avez créé au cours de cette procédure.
- Custom domain names for private APIs
-
La procédure suivante décrit comment acheminer le trafic vers un point de terminaison API Gateway pour un nom de domaine personnalisé pour un domaine privé APIs.
Pour acheminer le trafic vers un point de terminaison API Gateway
Ouvrez la console Route 53 à l'adresse https://console.aws.amazon.com/route53/.
Dans le panneau de navigation, choisissez Zones hébergées.
Choisissez le nom de la zone hébergée privée qui possède le nom de domaine que vous souhaitez utiliser pour acheminer le trafic vers votre API.
Choisissez Créer un registre.
Indiquez l’une des valeurs suivantes :
- Stratégie de routage
-
Choisissez la stratégie de routage applicable. Pour de plus amples informations, veuillez consulter Sélection d'une stratégie de routage.
- Nom de l'enregistrement
-
Entrez le nom de domaine que vous souhaitez utiliser pour acheminer le trafic vers votre API.
L'API vers laquelle vous souhaitez acheminer le trafic doit inclure un nom de domaine personnalisé, comme api.example.com, qui correspond au nom de l'enregistrement Route 53.
- Alias
-
Activez Alias.
- Valeur/acheminer le trafic vers
-
Choisissez Alias to VPC Endpoint. Choisissez la région d'où provient le point de terminaison, puis sélectionnez votre point de terminaison VPC.
- Type de registre
-
Si vous utilisez IPv6 pour votre point de terminaison VPC, créez un type d'enregistrement AAAA. Si vous utilisez DualStack pour votre point de terminaison VPC, créez à la fois un enregistrement de type AAAA et un type d'enregistrement A.
- Évaluer l'état de la cible
-
Pour contrôler le basculement DNS, configurez des surveillances de l'état personnalisés. Par exemple, consultez Configurer des surveillances de l'état personnalisés pour le basculement DNS dans le guide de l'utilisateur d'API Gateway.
-
Choisissez Créer des enregistrements.
Les changements se propagent généralement sur tous les serveurs Route 53 en 60 secondes. Lorsque la propagation est terminée, vous pourrez acheminer le trafic vers votre API en utilisant le nom de l'enregistrement d'alias que vous avez créé au cours de cette procédure.
