Tipi di indirizzo IP per nomi di dominio personalizzati per API HTTP - Gateway Amazon API

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 nomi di dominio personalizzati per API HTTP

Quando si crea un’API, è possibile specificare il tipo di indirizzo IP che può invocare il dominio. È possibile scegliere IPv4 per risolvere gli indirizzi IPv4 per invocare il dominio oppure dualstack per consentire a entrambi gli indirizzi IPv4 e IPv6 di invocare il dominio. È 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 i nomi di dominio personalizzati di Gateway API è IPv4.

  • Per il nome di dominio personalizzato, non è necessario che tutte le API mappate ad esso abbiano lo stesso tipo di indirizzo IP. 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 nome di dominio personalizzato

È possibile modificare il tipo di indirizzo IP aggiornando la configurazione dell’endpoint del dominio. È possibile aggiornare la configurazione dell’endpoint del dominio utilizzando la Console di gestione AWS, AWS CLI, CloudFormation o un AWS SDK.

Console di gestione AWS
Per modificare il tipo di indirizzo IP di un nome di dominio personalizzato
  1. Accedere alla console API Gateway all'indirizzo https://console.aws.amazon.com/apigateway.

  2. Scegliere un nome di dominio personalizzato pubblico.

  3. Scegliere Configurazione endpoint.

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

  5. Selezionare Salva.

AWS CLI

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

aws apigatewayv2 update-domain-name \ --domain-name dualstack.example.com \ --domain-name-configurations CertificateArn=arn:aws:acm:us-east-1:111122223333:certificate/abcd1234-5678-abc,IpAddressType=dualstack

L'output sarà simile al seguente:

{ "ApiMappingSelectionExpression": "$request.basepath", "DomainName": "dualstack.example.com", "DomainNameConfigurations": [ { "ApiGatewayDomainName": "d-abcd1234.execute-api.us-east-1.amazonaws.com", "CertificateArn": "arn:aws:acm:us-east-1:111122223333:certificate/abcd1234-5678-abc", "DomainNameStatus": "AVAILABLE", "EndpointType": "REGIONAL", "HostedZoneId": "Z3LQWSYCGH4ADY", "SecurityPolicy": "TLS_1_2", "IpAddressType": "dualstack" } ], "Tags": {} }