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 endpoint API per le API REST in API Gateway
Per tipo di endpoint API si intende il nome host dell'API. Il tipo di endpoint di API può essere ottimizzato per i confini, 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 indirizza le richieste al CloudFront Point of Presence (POP) più vicino, il che può essere utile nei casi in cui i clienti sono distribuiti geograficamente. 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 del cookie prima di inoltrare la richiesta all'origine. Per ulteriori informazioni sul modo in cui CloudFront elabora i cookie, consulta Memorizzazione nella cache dei contenuti basati sui 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 ai clienti nella stessa regione. Quando un client in esecuzione su un'istanza EC2 chiama un'API nella stessa regione o quando un'API è destinata a servire un numero limitato di client con richieste elevate, un'API regionale riduce il sovraccarico di connessione.
Per un'API regionale, qualsiasi nome di dominio personalizzato utilizzato è specifico della regione in cui viene distribuita 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 Configura un nome di dominio personalizzato regionale in API Gateway e Configura un nome di dominio personalizzato ottimizzato per l'edge in API Gateway.
Gli endpoint di API regionali passano tutti i nomi di intestazione senza alcuna modifica.
Nota
Nei casi in cui i client API siano distribuiti geograficamente, può comunque essere opportuno utilizzare un endpoint API regionale, insieme alla propria CloudFront distribuzione Amazon per garantire che API Gateway non associ l'API a distribuzioni controllate dal servizio. CloudFront Per ulteriori informazioni su questo caso d'uso, vedi Come posso configurare API Gateway con la mia CloudFront distribuzione?
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 API REST private in API Gateway.
Gli endpoint API privati passano tutti i nomi delle intestazioni senza alcuna modifica.
