Types d’adresses IP pour les API HTTP dans API Gateway - Amazon API Gateway

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.

Types d’adresses IP pour les API HTTP dans API Gateway

Lorsque vous créez une API, vous spécifiez le type d’adresses IP qui peut invoquer votre API. Vous avez le choix entre IPv4 (pour autoriser les adresses IPv4 à invoquer votre API) et Dualstack (pour autoriser les adresses IPv4 et IPv6 à invoquer votre API). Vous pouvez définir le type d’adresse IP sur Dualstack pour éviter l’épuisement de l’espace IP ou renforcer votre niveau de sécurité. Pour plus d’informations sur les avantages d’un type d’adresse IP à double pile, consultez IPv6 sur AWS.

Considérations relatives aux types d’adresses IP

Les considérations suivantes peuvent avoir une incidence sur votre utilisation des types d’adresses IP :

  • Le type d’adresses IP par défaut pour toutes les API HTTP est IPv4.

  • Si vous remplacez le type d’adresse IP IPv4 d’une API existante par un type d’adresse IP à double pile, vérifiez que toutes les stratégies d’accès à vos API ont été mises à jour pour prendre en compte les appels IPv6. La modification du type d’adresse IP prend effet immédiatement.

  • Votre API peut être mappée à un nom de domaine personnalisé présentant un type d’adresse IP différent de celui de votre API. La désactivation du point de terminaison de votre API par défaut peut avoir une incidence sur la manière dont les appelants peuvent invoquer votre API.

Modification du type d’adresse IP d’une API HTTP

Vous pouvez modifier le type d’adresse IP en mettant à jour la configuration de l’API. Vous pouvez mettre à jour la configuration de l’API à l’aide de la AWS Management Console, de l’AWS CLI, d’AWS CloudFormation ou d’un kit SDK AWS. Si vous modifiez le type d’adresse IP de l’API, vous n’avez pas besoin de redéployer votre API pour que les modifications prennent effet.

AWS Management Console
Pour modifier le type d’adresse IP d’une API HTTP
  1. Connectez-vous à la console API Gateway à l’adresse : https://console.aws.amazon.com/apigateway.

  2. Choisissez une API HTTP.

  3. Pour Paramètres de l’API, choisissez Modifier.

  4. Pour Type d’adresse IP, choisissez IPv4 ou Dualstack.

  5. Choisissez Save (Enregistrer).

    La modification de la configuration de votre API prend effet immédiatement.

AWS CLI

La commande update-api suivante met à jour une API pour qu’elle possède le type d’adresse IP Dualstack :

aws apigatewayv2 update-api \ --api-id abcd1234 \ --ip-address-type dualstack

Le résultat se présente comme suit :

{ "ApiEndpoint": "https://abcd1234.execute-api.us-east-1.amazonaws.com", "ApiId": "abcd1234", "ApiKeySelectionExpression": "$request.header.x-api-key", "CreatedDate": "2025-02-04T22:20:20+00:00", "DisableExecuteApiEndpoint": false, "Name": "My-HTTP-API", "ProtocolType": "HTTP", "RouteSelectionExpression": "$request.method $request.path", "Tags": {}, "NotificationUris": [], "IpAddressType": "dualstack" }