Acheminement du trafic vers un Amazon API Gateway à API l'aide de votre nom de domaine - Amazon Route 53
PrérequisConfiguration de Route 53 pour acheminer le trafic vers un point de terminaison de API passerelle

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.

Acheminement du trafic vers un Amazon API Gateway à API l'aide de votre nom de domaine

Vous pouvez utiliser Amazon API Gateway pour créer, publier, gérer, surveiller et sécuriserAPIs. 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 de domaine vers une API passerelle API est la même, que vous ayez créé un point de terminaison de API passerelle régional ou un point de terminaison de API passerelle optimisé pour les périphériques.

  • Point de APIterminaison régional : vous créez un enregistrement d'alias Route 53 qui achemine le trafic vers le point de API terminaison régional.

  • Point de APIterminaison optimisé pour les périphériques : vous créez un enregistrement d'alias Route 53 qui achemine le trafic vers le point optimisé pour les périphériques. API Cela entraîne le routage du trafic vers la distribution associée à la CloudFront distribution optimisée pour les périphériques. API

Un enregistrement alias est une extension Route 53 similaire à un CNAME enregistrement. DNS Pour une comparaison entre l'alias et CNAME les enregistrements, voirChoix entre des enregistrements avec ou sans alias.

Note

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 :

Configuration de Route 53 pour acheminer le trafic vers un point de terminaison de API passerelle

Pour configurer Route 53 afin d'acheminer le trafic vers un point de terminaison de API passerelle, effectuez 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 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 possède le nom de domaine que vous souhaitez utiliser pour acheminer le trafic vers votreAPI.

  5. Choisissez Créer un registre.

  6. Indiquez l'une des valeurs suivantes :

    Important

    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 identifiant privé DNS activé pour appeler un nom privéAPI. Le mode privé DNS remplace le comportement de DNS résolution par défaut au sein duVPC, ce qui peut entraîner des conflits avec les DNS enregistrements 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 votreAPI.

    Le vers API lequel vous souhaitez acheminer le trafic doit inclure un nom de domaine personnalisé, tel que 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, puis choisissez la région d'où provient le point de terminaison.

    La façon dont vous spécifiez la valeur pour Endpoint dépend du fait que vous avez créé la zone hébergée et que vous API utilisez 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 DNS basculement, configurez des contrôles de santé personnalisés. Par exemple, voir Configurer des contrôles de santé personnalisés pour le DNS basculement dans le guide de l'utilisateur de 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. Une fois la propagation terminée, vous pourrez acheminer le trafic vers votre en API utilisant le nom de l'enregistrement d'alias que vous avez créé dans cette procédure.