API-Gateway-API-Endpunkttypen - Amazon API Gateway

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

API-Gateway-API-Endpunkttypen

Ein API-Endpunkt-Typ bezieht sich auf den Hostnamen der API. Der API-Endpunkttyp kann Edge-optimiert, regional oder privat sein, je nachdem, woher der Großteil Ihres API-Datenverkehrs stammt.

Edge-optimierte API-Endpunkte

Ein Edge-optimierter API-Endpunkt leitet Anfragen in der Regel an den nächstgelegenen CloudFront Point of Presence (POP) weiter, was in Fällen hilfreich sein kann, in denen Ihre Kunden geografisch verteilt sind. Dies ist der Standard-Endpunkttyp für API Gateway-REST-APIs.

Edge-optimierte APIs profitieren von den Namen der HTTP-Header (z. B. Cookie).

CloudFront sortiert HTTP-Cookies in natürlicher Reihenfolge nach dem Namen des Cookies, bevor die Anfrage an Ihren Absender weitergeleitet wird. Weitere Informationen zur Art und Weise, wie Cookies CloudFront verarbeitet werden, finden Sie unter Zwischenspeichern von Inhalten auf der Grundlage von Cookies.

Jeder von Ihnen für eine Edge-optimierte API verwendeter benutzerdefinierter Domänenname gilt für alle Regionen.

Regionale API-Endpunkte

Ein regionaler API-Endpunkt ist für Clients in derselben Region vorgesehen. Wenn ein Client, der auf einer EC2-Instance ausgeführt wird, eine API in derselben Region aufruft oder wenn eine API eine kleine Anzahl von Clients mit hohen Anforderungen bedienen soll, reduziert eine regionale API den Verbindungsaufwand.

Bei einer regionalen API ist jeder benutzerdefinierte Domainname, den Sie verwenden, spezifisch für die Region, in der die API bereitgestellt wird. Wenn Sie eine regionale API in mehreren Regionen bereitstellen, kann sie in allen Regionen den gleichen Domänennamen haben. Sie können benutzerdefinierte Domänen zusammen mit Amazon Route 53 verwenden, um Aufgaben wie latenzbasiertes Routing auszuführen. Weitere Informationen erhalten Sie unter Einrichten eines regionalen benutzerdefinierten Domänennamens in API Gateway und Erstellen eines Edge-optimierten benutzerdefinierten Domänennamens.

Regionale API-Endpunkte übergeben alle Headernamen unverändert.

Anmerkung

In Fällen, in denen API-Clients geografisch verstreut sind, kann es dennoch sinnvoll sein, einen regionalen API-Endpunkt zusammen mit Ihrer eigenen CloudFront Amazon-Distribution zu verwenden, um sicherzustellen, dass API Gateway die API nicht mit CloudFront servicegesteuerten Distributionen verknüpft. Weitere Informationen zu diesem Anwendungsfall finden Sie unter Wie richte ich API Gateway mit meiner eigenen CloudFront Distribution ein? .

Private API-Endpunkte

Ein privater API-Endpunkt ist ein API-Endpunkt, auf den nur von Ihrer Amazon Virtual Private Cloud (VPC) aus zugegriffen werden kann, und zwar über einen Interface-VPC-Endpunkt, bei dem es sich um eine Endpunkt-Netzwerkschnittstelle (ENI) handelt, die Sie in Ihrer VPC erstellen. Weitere Informationen finden Sie unter Private REST-APIs im Amazon API Gateway.

Private API-Endpunkte übergeben alle Headernamen unverändert.