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 des API. Vous pouvez créer des API qui accèdent à AWS des services 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.

• 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.

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.

Note

Route 53 ne facture pas les requêtes d'alias adressées aux API API Gateway 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 :

  • Configuration des noms de domaine personnalisés pour les API HTTP dans le Guide du développeur Amazon API Gateway.

  • Configuration des noms de domaine personnalisés pour les API REST dans le Guide du développeur Amazon API Gateway.

  • Configuration de noms de domaine personnalisés pour les WebSocket API dans le manuel Amazon API Gateway Developer Guide.

• 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.

Pour acheminer le trafic vers un point de terminaison API Gateway

1. 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 :

   1. Connectez-vous à la console API Gateway AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/apigateway/.

   2. Dans le panneau de navigation, sélectionnez Custom domain names (Noms de domaine personnalisés).

   3. Sélectionnez le nom de domaine personnalisé que vous souhaitez utiliser et obtenez la valeur du nom de domaine de l'API Gateway.

2. Ouvrez la console Route 53 à l'adresse https://console.aws.amazon.com/route53/.

3. Dans le panneau de navigation, choisissez Zones hébergées.

4. 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.

5. Choisissez Créer un registre.

6. Indiquez l'une des valeurs suivantes :

   Stratégie de routage

   Choisissez la stratégie de routage applicable. Pour plus d’informations, consultez 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 cible inclut uniquement les API ayant un nom de domaine personnalisé qui correspond à la valeur que vous avez indiquée pour Record name (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 – adresse IPv4.

   É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.

7. Choisissez Create records (Créer des registres).

   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.