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-Endpunkttypen für REST APIs in API Gateway Ein *[API-Endpunkt](api-gateway-basic-concept.md#apigateway-definition-api-endpoints)*-Typ bezieht sich auf den Hostnamen der API. Der API-Endpunkttyp kann *Edge-optimiert*, *Regional* oder *Privat* sein, je nachdem, woher der Großteil des API-Datenverkehrs stammt. ## Edge-optimierte API-Endpunkte Ein *[Edge-optimierter API-Endpunkt](api-gateway-basic-concept.md#apigateway-definition-edge-optimized-api-endpoint)* 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-optimiert schreibt APIs die Namen von [HTTP-Headern groß (z. B.](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers)). `Cookie` CloudFront sortiert HTTP-Cookies in natürlicher Reihenfolge nach dem Namen des Cookies, bevor die Anfrage an Ihren Ursprung weitergeleitet wird. Weitere Informationen zur Art und Weise, wie Cookies CloudFront verarbeitet werden, finden Sie unter [Zwischenspeichern von Inhalten auf der Grundlage von Cookies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Cookies.html). 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](api-gateway-basic-concept.md#apigateway-definition-regional-api-endpoint)* ist für Clients in derselben Region konzipiert. Wenn ein Client, der auf einer EC2-Instance ausgeführt wird, eine API in der gleichen Region aufruft oder wenn eine API eine kleine Anzahl von Clients mit hohen Anforderungen bedienen soll, reduziert eine regionale API den Verbindungs-Overhead. Für eine regionale API gilt jeder von Ihnen verwendeter benutzerdefinierter Domainname 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 Domainnamen haben. Sie können benutzerdefinierte Domänen zusammen mit Amazon Route 53 verwenden, um Aufgaben wie [latenzbasiertes Routing](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-latency) auszuführen. Weitere Informationen erhalten Sie unter [Einrichten eines regionalen benutzerdefinierten Domainnamens in API Gateway](apigateway-regional-api-custom-domain-create.md) und [Einrichten eines Edge-optimierten benutzerdefinierten Domainnamens in API Gateway](how-to-edge-optimized-custom-domain-name.md). 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?](https://repost.aws/knowledge-center/api-gateway-cloudfront-distribution) . ## Private API-Endpunkte Ein *[privater API-Endpunkt](api-gateway-basic-concept.md#apigateway-definition-private-api-endpoint)* 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 [Privates REST APIs im API Gateway](apigateway-private-apis.md). Private API-Endpunkte übergeben alle Headernamen unverändert. # Öffentlichen oder privaten API-Endpunkttyp in API Gateway ändern Das Ändern eines API-Endpunkttyps erfordert, dass Sie die Konfiguration der API aktualisieren. Sie können einen vorhandenen API-Typ mit der API Gateway-Konsole AWS CLI, dem oder einem AWS SDK für API Gateway ändern. Der Endpunkttyp kann erst wieder geändert werden, wenn die aktuelle Änderung abgeschlossen ist, aber Ihre API ist verfügbar. Die folgenden Änderungen am Endpunkttyp werden nicht unterstützt: + Von Edge-optimiert in regional oder privat + Von regional in Edge-optimiert oder privat + Von privat in regional Sie können eine private API nicht in eine Edge-optimierte API ändern. Wenn Sie eine öffentliche API von Edge-optimiert in regional (oder umgekehrt) umwandeln, sollten Sie beachten, dass eine Edge-optimierte API sich anders als eine regionale API verhalten kann. Bei einer Edge-optimierten API wird beispielsweise der `Content-MD5`-Header entfernt. Jeder MD5 Hashwert, der an das Backend übergeben wird, kann in einem Anforderungszeichenfolgenparameter oder einer Body-Eigenschaft ausgedrückt werden. Die regionale API übergibt diesen Header jedoch, obwohl dadurch der Header-Name einem anderen Namen zugeordnet werden kann. Sie müssen die Unterschiede verstehen, um zu entscheiden, wie Sie eine Edge-optimierte API zu einer regionalen oder umgekehrt machen. **Topics** + [ ## API-Endpunkttyp über die API Gateway-Konsole ändern ](#migrate-api-using-console) + [ ## Verwenden Sie den AWS CLI , um den Typ eines API-Endpunkts zu ändern ](#migrate-api-using-aws-cli) ## API-Endpunkttyp über die API Gateway-Konsole ändern Um den API-Endpunkttyp Ihrer API zu ändern, führen Sie einen der folgenden Schritte aus: **So wandeln Sie einen öffentlichen Endpunkt von regional zu Edge-optimiert oder umgekehrt um** 1. Melden Sie sich bei der API Gateway Gateway-Konsole unter [https://console.aws.amazon.com/apigatewayan](https://console.aws.amazon.com/apigateway). 1. Wählen Sie eine REST-API aus. 1. Wählen Sie **API-Einstellungen** aus. 1. Wählen Sie im Abschnitt **API-Details** die Option **Bearbeiten** aus. 1. Wählen Sie als **API-Endpunkttyp** entweder **Edge-optimiert** oder **Regional** aus. 1. Wählen Sie **Änderungen speichern ** aus. 1. Stellen Sie die API erneut bereit, sodass die Änderungen wirksam werden. **So konvertieren Sie einen privaten Endpunkt in einen regionalen Endpunkt** 1. Melden Sie sich bei der API Gateway Gateway-Konsole unter [https://console.aws.amazon.com/apigatewayan](https://console.aws.amazon.com/apigateway). 1. Wählen Sie eine REST-API aus. 1. Bearbeiten Sie die Ressourcenrichtlinie für Ihre API, um jegliche Erwähnung von VPCs VPC-Endpunkten zu entfernen, sodass API-Aufrufe sowohl von außerhalb Ihrer VPC als auch innerhalb Ihrer VPC erfolgreich sind. 1. Wählen Sie **API-Einstellungen** aus. 1. Wählen Sie im Abschnitt **API-Details** die Option **Bearbeiten** aus. 1. Wählen Sie für **API-Endpunkttyp** die Option **Regional** aus. 1. Wählen Sie **Änderungen speichern ** aus. 1. Entfernen Sie die Ressourcenrichtlinie aus Ihrer API. 1. Stellen Sie die API erneut bereit, sodass die Änderungen wirksam werden. Da Sie den Endpunkttyp von privat zu regional migrieren, ändert API Gateway den IP-Adresstyp in IPv4. Weitere Informationen finden Sie unter [IP-Adresstypen für REST-APIs in API Gateway](api-gateway-ip-address-type.md). **So konvertieren Sie einen privaten Endpunkt in einen regionalen Endpunkt** 1. Melden Sie sich bei der API Gateway Gateway-Konsole unter [https://console.aws.amazon.com/apigatewayan](https://console.aws.amazon.com/apigateway). 1. Wählen Sie eine REST-API aus. 1. Erstellen Sie eine Ressourcenrichtlinie, die Zugriff auf Ihre VPC oder Ihren VPC-Endpunkt gewährt. Weitere Informationen finden Sie unter [Schritt 3: Einrichten einer Ressourcenrichtlinie für eine private API](apigateway-private-api-create.md#apigateway-private-api-set-up-resource-policy). 1. Wählen Sie **API-Einstellungen** aus. 1. Wählen Sie im Abschnitt **API-Details** die Option **Bearbeiten** aus. 1. Wählen Sie für **API endpoint type** (API-Endpunkttyp) die Option **Private** (Privat) aus. 1. (Optional) Wählen Sie für **VPC-Endpunkt IDs** den VPC-Endpunkt aus IDs , den Sie mit Ihrer privaten API verknüpfen möchten. 1. Wählen Sie **Änderungen speichern ** aus. 1. Stellen Sie die API erneut bereit, sodass die Änderungen wirksam werden. Da Sie den Endpunkttyp von „Regional“ zu „Privat“ migrieren, ändert API Gateway den IP-Adresstyp in „Dualstack“. Weitere Informationen finden Sie unter [IP-Adresstypen für REST-APIs in API Gateway](api-gateway-ip-address-type.md). ## Verwenden Sie den AWS CLI , um den Typ eines API-Endpunkts zu ändern Mit dem folgenden [update-rest-api](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-rest-api.html)Befehl wird eine Edge-optimierte API auf eine regionale API aktualisiert: ``` aws apigateway update-rest-api \ --rest-api-id a1b2c3 \ --patch-operations op=replace,path=/endpointConfiguration/types/EDGE,value=REGIONAL ``` Die erfolgreiche Antwort verfügt über einen Statuscode von `200 OK` und eine Nutzlast, die etwa wie folgt aussieht: ``` { "createdDate": "2017-10-16T04:09:31Z", "description": "Your first API with Amazon API Gateway. This is a sample API that integrates via HTTP with our demo Pet Store endpoints", "endpointConfiguration": { "types": "REGIONAL" }, "id": "a1b2c3", "name": "PetStore imported as edge-optimized" } ``` Mit dem folgenden [update-rest-api](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-rest-api.html)Befehl wird eine regionale API auf eine Edge-optimierte API aktualisiert: ``` aws apigateway update-rest-api \ --rest-api-id a1b2c3 \ --patch-operations op=replace,path=/endpointConfiguration/types/REGIONAL,value=EDGE ``` Da er [put-rest-api](https://docs.aws.amazon.com/cli/latest/reference/apigateway/put-rest-api.html)für die Aktualisierung von API-Definitionen bestimmt ist, gilt er nicht für die Aktualisierung eines API-Endpunkttyps.