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

Tipi di indirizzo IP per API WebSocket 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. È consigliabile 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 tutte le API WebSocket è 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 WebSocket

È 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 WebSocket
  1. Accedere alla console API Gateway all'indirizzo https://console.aws.amazon.com/apigateway.

  2. Scegli un'API WebSocket.

  3. Scegliere Impostazioni API, quindi 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-WebSocket-API", "ProtocolType": "WEBSOCKET", "RouteSelectionExpression": "$request.method $request.path", "Tags": {}, "NotificationUris": [], "IpAddressType": "dualstack" }