View a markdown version of this page

Routing del traffico a un'API di Amazon API Gateway usando il proprio nome di dominio - Amazon Route 53

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à.

Routing del traffico a un'API di Amazon API Gateway usando il proprio nome di dominio

Per creare, pubblicare, mantenere, monitorare e proteggere le API puoi utilizzare Gateway Amazon API. Puoi creare API che accedono a AWS servizi o altri servizi Web oltre ai dati archiviati nel AWS cloud.

Il metodo utilizzato per indirizzare il traffico di dominio verso un'API API Gateway è lo stesso indipendentemente dal fatto che sia stato creato un endpoint API Gateway regionale o un endpoint API Gateway ottimizzato per l'edge. Se crei un endpoint API Gateway privato, il processo è leggermente diverso.

  • Endpoint API regionale: crei un record alias Route 53 che indirizza il traffico verso l'endpoint API regionale.

  • Edge-optimized Endpoint API: crei un record alias Route 53 che indirizza il traffico verso l'API ottimizzata per l'edge. Questo fa sì che il traffico venga indirizzato alla CloudFront distribuzione associata all'API ottimizzata per l'edge.

  • Endpoint API privato: crei un record alias Route 53 che indirizza il traffico al tuo endpoint API privato utilizzando un endpoint VPC di interfaccia per API Gateway in una zona ospitata privata.

Un record alias è un'estensione di Route 53 al DNS simile a un record CNAME. Per un confronto tra alias e record CNAME, consulta Scelta tra record alias e non alias.

Nota

Route 53 non addebita alcun costo per le richieste di alias alle API API Gateway o ad altre risorse. AWS

Prerequisiti

Per iniziare, è necessario avere a disposizione quanto segue:

Configurazione di Route 53 per instradare il traffico a un endpoint API Gateway

Per configurare Route 53 per instradare il traffico a un endpoint di API Gateway, completa la seguente procedura.

Custom domain names for public APIs

La procedura seguente descrive come indirizzare il traffico verso un endpoint API Gateway per un nome di dominio personalizzato per le API pubbliche.

Come instradare il traffico a un endpoint di API Gateway
  1. Se la zona ospitata Route 53 e l'endpoint sono stati creati utilizzando lo stesso account, passa alla fase 2.

    Se la zona ospitata e l'endpoint sono stati creati utilizzando account diversi, recupera il nome di dominio di destinazione per il nome di dominio personalizzato che desideri utilizzare:

    1. Accedi Console di gestione AWS e apri la console API Gateway all'indirizzo. https://console.aws.amazon.com/apigateway/

    2. Nel pannello di navigazione, scegli Nomi di dominio personalizzati.

    3. Seleziona il nome di dominio personalizzato che desideri utilizzare e recupera il valore di Nome dominio di API Gateway.

  2. Apri la console Route 53 all'indirizzo https://console.aws.amazon.com/route53/.

  3. Nel pannello di navigazione, scegli Zone ospitate.

  4. Scegli il nome della zona ospitata che ha il nome di dominio che desideri utilizzare per instradare il traffico verso l'API.

  5. Scegli Crea record.

  6. Specifica i seguenti valori:

    Importante

    Ti consigliamo di attivare Alias. Per i nomi di dominio che non utilizzano un record Route 53 Alias, potresti riscontrare problemi se utilizzi un VPC con DNS privato abilitato a richiamare un'API privata. Il DNS privato ha la precedenza sul comportamento di risoluzione DNS predefinito all'interno del VPC, il che potrebbe causare conflitti con i record DNS esterni.

    Policy di routing

    Scegliere la policy di routing applicabile. Per ulteriori informazioni, consulta Scegliere una policy di routing.

    Nome record

    Immettere il nome di dominio da utilizzare per instradare il traffico verso l'API.

    L'API verso cui instradare il traffico deve includere un nome di dominio personalizzato, ad esempio api.example.com, che corrisponde al nome del record Route 53.

    Alias

    Se stai usando il metodo di creazione record Creazione rapida, attiva Alias.

    Value/Route traffico verso

    Scegli Alias per l'API di API Gateway, quindi scegli la regione da cui proviene l'endpoint.

    Il modo in cui specifichi il valore per Endpoint dipende dal fatto che tu abbia creato la zona ospitata e l'API utilizzando lo stesso AWS account o account diversi:

    • Stesso account: l'elenco dei nomi di dominio di destinazione include solo le API che dispongono di un nome di dominio personalizzato che corrisponde al valore specificato per Nome record. Scegli il valore applicabile.

    • Account diversi: specifica il valore ottenuto nella fase 1 di questa procedura.

    Tipo di record

    Selezionare A – IPv4 address (A – indirizzo IPv4).

    Valutazione dello stato della destinazione

    Per verificare il failover DNS, configura i controlli dell'integrità personalizzati. Per un esempio, consulta la sezione Configurare i controlli dell'integrità personalizzati per il failover DNS nella Guida per l'utente di API Gateway.

  7. Scegli Crea record.

    In genere le modifiche si propagano a tutti i server Route 53 entro 60 secondi. Al termine della propagazione, sarà possibile instradare il traffico all'istanza API; utilizzando il record alias creato in questa procedura.

Custom domain names for private APIs

La procedura seguente descrive come indirizzare il traffico verso un endpoint API Gateway per un nome di dominio personalizzato per API private.

Come instradare il traffico a un endpoint di API Gateway
  1. Apri la console Route 53 all'indirizzo. https://console.aws.amazon.com/route53/

  2. Nel pannello di navigazione, scegli Zone ospitate.

  3. Scegli il nome della zona ospitata privata con il nome di dominio che desideri utilizzare per indirizzare il traffico verso la tua API.

  4. Scegli Crea record.

  5. Specifica i seguenti valori:

    Policy di routing

    Scegliere la policy di routing applicabile. Per ulteriori informazioni, consulta Scegliere una policy di routing.

    Nome record

    Immettere il nome di dominio da utilizzare per instradare il traffico verso l'API.

    L'API verso cui instradare il traffico deve includere un nome di dominio personalizzato, ad esempio api.example.com, che corrisponde al nome del record Route 53.

    Alias

    Attiva Alias.

    Value/Route traffico verso

    Scegli Alias to VPC Endpoint. Scegli la regione da cui proviene l'endpoint, quindi seleziona il tuo endpoint VPC.

    Tipo di record

    Se utilizzi IPv6 per il tuo endpoint VPC, crea un tipo di record AAAA. Se utilizzi dualstack per il tuo endpoint VPC, crea un tipo di record sia AAAA che A.

    Valutazione dello stato della destinazione

    Per verificare il failover DNS, configura i controlli dell'integrità personalizzati. Per un esempio, consulta la sezione Configurare i controlli dell'integrità personalizzati per il failover DNS nella Guida per l'utente di API Gateway.

  6. Scegli Crea record.

    In genere le modifiche si propagano a tutti i server Route 53 entro 60 secondi. Al termine della propagazione, sarà possibile instradare il traffico all'istanza API; utilizzando il record alias creato in questa procedura.