Tipi di endpoint API per REST API in Gateway API
Per tipo di endpoint API si intende il nome host dell'API. Il tipo di endpoint dell’API può essere ottimizzato per l’edge, regionale o privato, a seconda della provenienza della maggior parte del traffico dell’API.
Endpoint API ottimizzati per edge
Un endpoint API ottimizzato per l'edge in genere instrada le richieste al point of presence (POP) CloudFront più vicino e questo può essere utile nei casi in cui i client sono in aree geograficamente distribuite. Questo è il tipo di endpoint di default per API REST API Gateway.
Le API ottimizzate per i confini utilizzano una lettera maiuscola iniziale per i nomi delle intestazioni HTTPCookie.
CloudFront ordina i cookie HTTP in ordine naturale in base al nome prima di inoltrare la richiesta al server di origine. Per ulteriori informazioni su come CloudFront elabora i cookie, consulta Memorizzazione nella cache di contenuti basati su cookie.
Qualsiasi nome di dominio utilizzato per un'API con edge ottimizzato si applica in tutte le regioni.
Endpoint API regionali
Un endpoint API regionale è destinato a client inclusi nella stessa Regione. L’API regionale riduce il sovraccarico delle connessioni nei casi in cui un client in esecuzione su un’istanza EC2 chiama un’API nella stessa Regione o un’API è destinata all’utilizzo da parte di un numero limitato di client con domanda elevata.
Per un’API regionale, il nome di dominio personalizzato è specifico della Regione in cui viene implementata l’API. Se si distribuisce un’API regionale in più Regioni, questa può avere lo stesso nome di dominio personalizzato in tutte le Regioni. È possibile utilizzare domini personalizzati insieme ad Amazon Route 53 per eseguire attività come l'instradamento basato su latenza. Per ulteriori informazioni, consulta Configurazione di un nome di dominio personalizzato regionale in Gateway API e Configurazione di un nome di dominio personalizzato ottimizzato per l'edge in Gateway API.
Gli endpoint di API regionali passano tutti i nomi di intestazione senza alcuna modifica.
Nota
Se i client API sono distribuiti geograficamente, potrebbe comunque essere opportuno utilizzare un endpoint API regionale con la distribuzione di Amazon CloudFront per fare in modo che Gateway API non associ l'API a distribuzioni di CloudFront controllate dal servizio. Per ulteriori informazioni su questo caso d'uso, consulta la pagina relativa alla procedura di configurazione di API Gateway con la distribuzione di CloudFront
Endpoint API privati
Un endpoint di API privato è un endpoint di API al quale è possibile accedere solo da Amazon Virtual Private Cloud (VPC) utilizzando un endpoint VPC di interfaccia, ovvero un'interfaccia di rete dell'endpoint creato nel VPC. Per ulteriori informazioni, consulta REST API private in Gateway API.
Gli endpoint API privati passano tutti i nomi delle intestazioni senza alcuna modifica.
