Tipi di indirizzo IP per nomi di dominio personalizzati in Gateway API - Gateway Amazon API
Considerazioni sui tipi di indirizzo IPModifica del tipo di indirizzo IP di un nome di dominio personalizzato

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 in Gateway API

Quando si crea un nome di dominio personalizzato, è possibile specificare il tipo di indirizzo IP che può invocare il dominio. Puoi scegliere di risolvere IPv4 gli indirizzi IPv4 per richiamare il tuo dominio oppure puoi scegliere dualstack per consentire sia IPv4 agli indirizzi che agli IPv6 indirizzi di richiamare il tuo 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 di un tipo di indirizzo IP dualstack, consulta on. IPv6 AWS

È possibile modificare il tipo di indirizzo IP aggiornando la configurazione dell’endpoint del nome di dominio.

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 per il pubblico di API Gateway APIs è IPv4.

  • Il tipo di indirizzo IP per i nomi di dominio personalizzati privati può essere solo dualstack.

  • Non è necessario che il nome di dominio personalizzato abbia lo stesso tipo di indirizzo IP per tutti gli indirizzi APIs mappati su di esso. Se si disabilita l’endpoint API predefinito, si potrebbe influire sul modo in cui i chiamanti possono invocare il dominio.

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 nome di dominio. Puoi aggiornare la configurazione dell'endpoint utilizzando il Console di gestione AWS, il 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. Accedi 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 il tipo di indirizzo IP, seleziona uno o Dualstack. IPv4

  5. Scegli Save (Salva).

AWS CLI

Il update-domain-namecomando seguente aggiorna un'API in modo che abbia un tipo di indirizzo IP dualstack:

aws apigateway update-domain-name \
    --domain-name dualstack.example.com \
    --patch-operations "op='replace',path='/endpointConfiguration/ipAddressType',value='dualstack'"

L'output sarà simile al seguente:

{
    "domainName": "dualstack.example.com",
    "certificateUploadDate": "2025-02-04T14:46:10-08:00",
    "regionalDomainName": "d-abcd1234.execute-api.us-east-1.amazonaws.com",
    "regionalHostedZoneId": "Z3LQWSYCGH4ADY",
    "regionalCertificateArn": "arn:aws:acm:us-east-1:111122223333:certificate/a1b2c3d4-5678-90ab-cdef",
    "endpointConfiguration": {
        "types": [
            "REGIONAL"
        ],
        "ipAddressType": "dualstack"
    },
    "domainNameStatus": "AVAILABLE",
    "securityPolicy": "TLS_1_2",
    "tags": {}
}