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.
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.
Themen
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
-
Melden Sie sich bei der API Gateway Gateway-Konsole unter https://console.aws.amazon.com/apigatewayan
. Wählen Sie eine REST-API aus.
Wählen Sie API-Einstellungen aus.
Wählen Sie im Abschnitt API-Details die Option Bearbeiten aus.
-
Wählen Sie als API-Endpunkttyp entweder Edge-optimiert oder Regional aus.
-
Wählen Sie Änderungen speichern.
-
Stellen Sie die API erneut bereit, sodass die Änderungen wirksam werden.
So konvertieren Sie einen privaten Endpunkt in einen regionalen Endpunkt
-
Melden Sie sich bei der API Gateway Gateway-Konsole unter https://console.aws.amazon.com/apigatewayan
. Wählen Sie eine REST-API aus.
-
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.
Wählen Sie API-Einstellungen aus.
Wählen Sie im Abschnitt API-Details die Option Bearbeiten aus.
-
Wählen Sie für API-Endpunkttyp die Option Regional aus.
-
Wählen Sie Änderungen speichern.
-
Entfernen Sie die Ressourcenrichtlinie aus Ihrer API.
-
Stellen Sie die API erneut bereit, sodass die Änderungen wirksam werden.
So konvertieren Sie einen privaten Endpunkt in einen regionalen Endpunkt
-
Melden Sie sich bei der API Gateway Gateway-Konsole unter https://console.aws.amazon.com/apigatewayan
. Wählen Sie eine REST-API aus.
-
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.
Wählen Sie API-Einstellungen aus.
Wählen Sie im Abschnitt API-Details die Option Bearbeiten aus.
-
Wählen Sie für API endpoint type (API-Endpunkttyp) die Option Private (Privat) aus.
-
(Optional) Wählen Sie für VPC-Endpunkt IDs den VPC-Endpunkt aus IDs , den Sie mit Ihrer privaten API verknüpfen möchten.
-
Wählen Sie Änderungen speichern.
-
Stellen Sie die API erneut bereit, sodass die Änderungen wirksam werden.
Verwenden Sie den AWS CLI , um den Typ eines API-Endpunkts zu ändern
Mit dem folgenden update-rest-apiBefehl 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-apiBefehl 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-apifür die Aktualisierung von API-Definitionen bestimmt ist, gilt er nicht für die Aktualisierung eines API-Endpunkttyps.
