Backend internal DNS resolution (dedicated instances only) - API Gateway

Un nom de domaine interne correspond à l'adresse d'un service backend que vous configurez dans API Gateway. Lorsqu'un service backend utilise un nom de domaine interne, API Gateway assure la résolution DNS au niveau de l'instance.

Présentation

Par exemple, si la résolution du nom de domaine interne de votre service backend s'effectue via PrivateZone, elle n'est effective qu'au sein du VPC spécifié. Étant donné qu'API Gateway ne réside pas dans votre VPC, il ne peut pas résoudre ce nom de domaine interne. Pour permettre l'accès à ce nom de domaine, configurez la résolution DNS interne dans API Gateway. Dans le cas d'une instance d'intégration VPC, vous pouvez également attribuer un poids à chaque enregistrement DNS afin de répartir le trafic. Le schéma ci-dessous illustre ce processus.

Étape 1 : Configurer la résolution DNS interne

1. Créer un enregistrement DNS interne

Connectez-vous à la console API Gateway. Dans le volet de navigation de gauche, cliquez sur Instances and Clusters et sélectionnez Dedicated Instances.
Cliquez sur l'onglet Internal DNS Resolution pour gérer les enregistrements DNS internes.
Dans le coin supérieur droit de la page, cliquez sur Add DNS Record. Spécifiez le Instance Type ainsi que l'Instance cible, puis saisissez le Internal Domain Name. Pour une instance d'intégration VPC, vous devez également configurer la Record Value et le Weight. Pour une instance dédiée classique, assurez-vous que le nom de domaine interne correspond à la valeur Host définie dans l'autorisation d'accès VPC.

Important
Le poids peut être défini sur une valeur comprise entre 0 et 100. Par exemple, si deux adresses IP ont des poids de 1 et 2, le trafic est réparti entre elles selon un ratio de 1:2. Si vous définissez le poids sur 0, aucun trafic n'est acheminé vers cette adresse IP.

Dans la boîte de dialogue, le champ Record Type est défini par défaut sur A (maps a domain name to an IPv4 address). Après l'ajout ou la mise à jour d'un enregistrement DNS, les modifications prennent effet en environ 10 minutes.

2. Modifier un enregistrement DNS interne

Cliquez sur Edit dans la colonne Actions pour modifier la Record Value et le Weight d'un enregistrement existant.

Remarque

Après l'ajout ou la modification d'un enregistrement DNS interne, les changements prennent effet en environ 10 minutes.

Étape 2 : Associer une instance dédiée

Vous pouvez associer un enregistrement DNS interne à une instance dédiée de deux manières.

Association lors de la création

Lors de la création d'un enregistrement DNS interne, sélectionnez l'instance cible dans la liste déroulante Instance. L'enregistrement est alors automatiquement associé à l'instance dédiée sélectionnée.

Association depuis la liste des instances

Connectez-vous à la console API Gateway. Dans le volet de navigation de gauche, cliquez sur Instances and Clusters et sélectionnez Dedicated Instances.
Cliquez sur l'onglet Instances. Dans la section Associated Internal Domain Name Resolutions des détails de l'instance, cliquez sur Associate. Dans la boîte de dialogue, sélectionnez l'enregistrement DNS interne à associer.

Remarque

Après avoir associé une instance dédiée à un enregistrement DNS interne ou après avoir mis à jour la valeur ou le poids de l'enregistrement, les modifications prennent effet en environ 10 minutes.

Notes d'utilisation

Une fois qu'un enregistrement DNS interne est associé à une instance dédiée, toute requête émanant de cette instance vers le nom de domaine interne spécifié est résolue vers l'adresse IP configurée dans l'enregistrement. Cela remplace toute résolution DNS publique pour ce nom de domaine.

Instances d'intégration VPC

Vous devez configurer un enregistrement DNS interne pour les services backend basés sur HTTP qui utilisent un nom de domaine interne. Sans cela, API Gateway ne peut pas résoudre le nom de domaine.
La valeur de l'enregistrement doit être une adresse IP située dans un bloc CIDR accessible du VPC du service backend.
Un enregistrement DNS interne comportant une seule adresse IP avec un poids de 0 est inefficace, car aucun trafic n'est transféré vers cette adresse IP.

Instances dédiées classiques

Lorsque vous utilisez une instance dédiée classique, vous devez vous assurer que le nom de domaine interne figurant dans l'enregistrement DNS interne correspond à la valeur Host configurée dans l'vpc access authorization. Lorsque API Gateway envoie une requête HTTPS au service défini dans l'autorisation d'accès VPC, il définit le Server Name Indication (SNI) lors de la poignée de main TLS sur la valeur Host configurée.

Remarque

Si une instance dédiée classique utilise une autorisation d'accès VPC via HTTPS sans qu'aucun enregistrement DNS interne ne soit configuré, le SNI n'est pas envoyé lors de la poignée de main TLS.

Limites

Cette fonctionnalité est disponible uniquement pour les instances dédiées.
Vous pouvez créer jusqu'à 100 enregistrements DNS internes par région.
Un enregistrement DNS interne peut être associé à plusieurs instances dédiées du même type.
Les enregistrements DNS internes ne peuvent pas être associés à un cluster d'instances dédiées.
Pour une instance d'intégration VPC :
- Seuls les enregistrements A, qui mappent un nom de domaine à une adresse IPv4, sont pris en charge.
- Vous pouvez configurer un maximum de 20 enregistrements A pour un nom de domaine interne.
Pour une instance dédiée classique :
- Seuls les enregistrements DNS internes de type autorisation d'accès VPC sont pris en charge.
- Vous ne pouvez pas ajouter de valeur d'enregistrement. Le trafic est acheminé par défaut vers l'adresse IP mappée par l'autorisation d'accès VPC.