Über Cloud Endpoints

Cloud Endpoints ist ein verteiltes API-Verwaltungssystem. Es bietet eine API Console sowie u. a. Hosting-, Logging- und Monitoring-Features, mit denen Sie APIs auf einfache Weise erstellen, freigeben, verwalten und schützen können. Auf dieser Seite erhalten Sie eine Übersicht über Cloud Endpoints für gRPC. Weitere Informationen zu anderen Arten von API-Frameworks, die von Endpoints unterstützt werden, finden Sie in den verschiedenen Endpoints-Dokumenten.

Endpoints kann für den verteilten Extensible Service Proxy (ESP) oder für Extensible Service Proxy V2 (ESPv2) verwendet werden. Jeder Proxy unterstützt die unten beschriebenen Plattformen:

  • Flexible App Engine-Umgebung (nur ESP)
  • Google Kubernetes Engine (ESP oder ESPv2)
  • Compute Engine (ESP oder ESPv2)
  • Kubernetes (ESP oder ESPv2)
  • App Engine-Standardumgebung (nur ESPv2)
  • Cloud Run-Funktionen (nur ESPv2)
  • Cloud Run (nur ESPv2)
  • Knative serving (nur ESPv2)

Endpunkte mit ESP

Endpoints verwendet den verteilten Extensible Service Proxy (ESP), um selbst anspruchsvollsten APIs niedrige Latenz und hohe Leistung zu bieten. Der ESP ist ein Dienstproxy, der auf NGINX basiert. Sie können also sicher sein, dass er zur Verarbeitung gleichzeitiger Anfragen an Ihre API entsprechend skaliert wird. Zur besseren Isolation und Skalierbarkeit wird der ESP in einem eigenen Docker-Container ausgeführt und in Container Registry verteilt. Sie können sie so verwenden:

Endpoints mit ESPv2

ESPv2 ist ein leistungsstarker, skalierbarer Proxy, der auf Envoy basiert und vor einem OpenAPI- oder gRPC-API-Backend ausgeführt wird. ESPv2 unterstützt Version 2 der OpenAPI-Spezifikation und gRPC-Spezifikationen. Sie können sie so verwenden:

Verwaltungsfunktionen der Endpoints-API

Unabhängig davon, ob Sie Endpoints mit dem ESP oder ESPv2 verwenden, stehen Ihnen viele API-Verwaltungsfunktionen zur Verfügung, mit denen Sie den Zugriff auf Ihre APIs entwickeln, beobachten und steuern können.

Logs und Messwerte

Endpoints verwendet Service Infrastructure, um APIs zu verwalten und Logs und Messwerte zu melden. Diese Infrastruktur wird von den meisten Google Cloud APIs verwendet. Sie können Ihre APIs auf der Seite Endpunkte-Dienste in der Google Cloud Console

API-Hosting

Endpoints wurde für die Docker-Containerumgebung optimiert. Sie können APIs überall dort hosten, wo Docker unterstützt wird. Voraussetzung ist lediglich, dass Sie Internetzugriff auf die Google Cloud haben.

gRPC API mit Cloud Endpoints entwickeln

  1. Definieren Sie einen gRPC API-Dienst mit Protokollzwischenspeicher und implementieren Sie diesen in einer beliebigen von gRPC unterstützten Sprache.

  2. Schreiben Sie die gRPC API-Dienstkonfiguration für Cloud Endpoints.

  3. Generieren Sie die API-Laufzeitkonfiguration für Ihre API und stellen Sie sie in Service Management bereit.

  4. Stellen Sie den API-Server bereit.

Weitere Informationen zur Verwendung von gRPC mit Endpoints finden Sie unter Endpoints für gRPC APIs und in den entsprechenden Anleitungen.

API-Zugriff steuern

Sie können mit Endpoints festlegen, dass für alle API-Aufrufe ein zu prüfender API-Schlüssel erforderlich ist. Sie können auch die Google Cloud Console verwenden, um Ihre API mit anderen Entwicklern zu teilen, damit diese kann Ihre API aktivieren und API-Schlüssel für den Aufruf generieren.

API-Nutzer authentifizieren

API-Aufrufe erfolgen in der Regel durch Nutzer. Während API-Schlüssel angeben, welche Anwendung Ihre API aufruft, wird durch den Authentifizierungsprozess bestimmt, welcher Nutzer die jeweilige Anwendung verwendet.

Der API-Server muss trotzdem noch entscheiden, was der authentifizierte Nutzer mit Ihrer API tun kann. Weitere Informationen finden Sie im Google Cloud-Authentifizierungsleitfaden.

Nächste Schritte

  • Machen Sie sich mit den Bereitstellungsschritten vertraut und sehen Sie sich Endpoints-Funktionen in Aktion im Schnellstart für Endpoints an. Dort wird mithilfe von Skripts eine Beispiel-API für ein Back-End der flexiblen App Engine-Umgebung bereitgestellt.

  • Mehr über die Verwendung von Endpoints erfahren Sie in unseren Anleitungen.