Tipi di indirizzo IP per API HTTP in Gateway API - Amazon API Gateway

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Tipi di indirizzo IP per API HTTP in Gateway API

Quando si crea un’API, è possibile specificare il tipo di indirizzo IP che può invocarla. È possibile scegliere IPv4 per risolvere gli indirizzi IPv4 per invocare l’API oppure dualstack per consentire a entrambi gli indirizzi IPv4 e IPv6 di invocare l’API. Si potrebbe voler impostare il tipo di indirizzo IP su dualstack per ridurre l’esaurimento dello spazio IP o per il livello di sicurezza. Per ulteriori informazioni sui vantaggi del tipo di indirizzo IP dualstack, consultare IPv6 on AWS.

Considerazioni sui tipi di indirizzo IP

Le seguenti considerazioni potrebbero influire sull’utilizzo dei tipi di indirizzo IP:

  • Il tipo di indirizzo IP predefinito per le API HTTP è IPv4.

  • Se per un’API esistente si modifica il tipo di indirizzo IP da IPv4 a dualstack, è necessario verificare che tutte le policy che controllano l’accesso alle API siano aggiornate in modo da tenere conto delle chiamate IPv6. Quando si modifica il tipo di indirizzo IP, la modifica diventa immediatamente effettiva.

  • L’API può essere mappata su un nome di dominio personalizzato con un tipo di indirizzo IP diverso da quello dell’API. Se si disabilita l’endpoint API predefinito, si potrebbe influire sul modo in cui i chiamanti possono invocare l’API.

Modifica del tipo di indirizzo IP di un’API HTTP

È possibile modificare il tipo di indirizzo IP aggiornando la configurazione dell’API. È possibile aggiornare la configurazione dell’API utilizzando la AWS Management Console, AWS CLI, AWS CloudFormation o un AWS SDK. Se si modifica il tipo di indirizzo IP dell’API, non è necessario eseguire di nuovo l’implementazione dell’API per rendere effettive le modifiche.

AWS Management Console
Per modificare il tipo di indirizzo IP di un’API HTTP
  1. Accedere alla console API Gateway all'indirizzo https://console.aws.amazon.com/apigateway.

  2. Scegliere un'API HTTP.

  3. Per Impostazioni API, scegliere Modifica.

  4. Per Tipo di indirizzo IP, selezionare IPv4 o Dualstack.

  5. Selezionare Salva.

    La modifica alla configurazione dell’API ha effetto immediato.

AWS CLI

Il comando update-api seguente aggiorna un’API in modo che abbia un tipo di indirizzo IP dualstack:

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

L'output sarà simile al seguente:

{ "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" }