Cloud Endpoints ist ein API-Verwaltungssystem, mit dem Sie mit der gleichen Infrastruktur, die Google für seine eigenen APIs nutzt, Ihre APIs schützen, überwachen und analysieren sowie dafür Kontingente festlegen können. Endpoints kann entweder mit Extensible Service Proxy (ESP) und mit Extensible Service Proxy V2 (ESPv2) bereitgestellt werden, um eine API-Verwaltung bereitzustellen. Weitere Informationen über Cloud Endpoints, ESP und ESPv2 finden Sie unter Über Cloud Endpoints.
Endpunkte unterstützt Version 2 der OpenAPI-Spezifikation (früher als Swagger-Spezifikation bezeichnet), den Branchenstandard für die Definition von REST APIs. Weitere Informationen zur BGP-Spezifikation finden Sie in der OpenAPI-Übersicht.
In dieser Dokumentation wird erläutert, wie Sie Endpunkte mit GCPW verwenden. Eine Dokumentation zu den anderen Endpunktoptionen finden Sie im Dokument zu allen Endpunkten.
Für einen schnellen Einstieg empfehlen wir, die Dokumentation in der folgenden Reihenfolge durchzuarbeiten:
Wenn Sie Cloud Endpoints-Funktionen in Aktion sehen möchten, gehen Sie den Schnellstart für Cloud Endpoints durch. Darin wird mithilfe von Skripts eine Beispiel-API in der flexiblen App Engine-Umgebung bereitgestellt.
Entscheiden Sie sich nun, welche Computing-Plattform Sie für Ihre API verwenden möchten. Als Entscheidungshilfe findest du unter Computing-Option auswählen und im Abschnitt Unterstützte Computing-Plattformen unten weitere Informationen.
Nachdem Sie das Back-End für Ihre API ausgewählt haben, lesen Sie die spezifische Anleitung für die von Ihnen gewünschte Computing-Plattform.
Unterstützte Computing-Plattformen
Endpoints für OpenAPI hängt entweder vom ESP oder ESPv2 für die API-Verwaltung ab. ESP und ESPv2 sind Open-Source-Projekte. Sie stehen Ihnen unter folgenden Möglichkeiten zur Verfügung:
- Als Container in Google Container Registry.
- Das aktuelle ESP-Docker-Image finden Sie bei den ESP-Versionshinweisen.
- Das aktuelle ESPv2 Docker-Image finden Sie bei den ESPv2-Versionshinweisen.
- Als Quellcode auf GitHub.
- Einzelheiten zum Erstellen des ESP finden Sie in der ESP-README-Datei.
- Informationen zum Erstellen von ESPv2 finden Sie in der README-Datei von ESPv2.
Sie können den ESP-Container auf den folgenden Plattformen ausführen:
- Flexible App Engine-Umgebung
- Compute Engine
- Kubernetes, einschließlich Google Kubernetes Engine
- Auf einem Linux- oder macOS-Computer oder einer anderen Plattform
Sie können den ESPv2 Beta-Container auf den folgenden Plattformen ausführen:
- App Engine
- Cloud Functions
- Cloud Run
- Cloud Run for Anthos
- GKE
- Compute Engine
- Kubernetes
Weitere Informationen finden Sie unter Über Cloud Endpoints.
In der flexiblen App Engine-Umgebung wird der ESP automatisch bereitgestellt, wenn Sie der Datei app.yaml einige Zeilen hinzufügen. Weitere Informationen finden Sie unter API und ESP bereitstellen. ESPv2 Beta unterstützt die flexible App Engine-Umgebung nicht.
Für die App Engine-Standardumgebung der Generation 1 müssen Sie Endpoints Frameworks verwenden. Wenn Sie den Container stattdessen für eine der oben genannten Computing-Optionen bereitstellen, können Sie einen Proxy für beide Generationen der App Engine-Standardlaufzeit ausführen.