Was sind Erweiterungen?

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zuApigee X wechseln. info

Mit Erweiterungen können Sie externe Ressourcen in Ihre API-Proxys einbinden. Sie können beispielsweise Google Cloud Platform-Dienste wie Google Cloud Storage einbinden. Ein API-Proxy verwendet die Erweiterung während der Laufzeit, um Anforderungen und Antworten mit der externen Ressource auszutauschen.

Laufzeit-Framework für Erweiterungen

Während der Laufzeit fungiert eine Erweiterung als Vermittler und verarbeitet Anfragen und Antworten zwischen einem API-Proxy und einer externen Ressource.

Hier ist eine Übersicht darüber, wie die Verarbeitung über eine Erweiterung während der Laufzeit funktioniert.

  1. Eine Clientanfrage erreicht einen API-Proxy und der Anfragestrom wird über die Richtlinien des Proxys verarbeitet.
  2. Der Anfragestrom erreicht im Proxy eine Extension Callout-Richtlinie , die so konfiguriert ist, dass Daten an eine in der Umgebung bereitgestellte Erweiterung übergeben werden. Die Daten enthalten Werte, die zum Senden einer Anfrage an die externe Ressource erforderlich sind, die die Erweiterung darstellt.
  3. Die Erweiterung sendet eine Anfrage an die externe Ressource und empfängt dann eine Antwort.
  4. Die Erweiterung gibt die Antwort an die Extension Callout-Richtlinie zurück, wo sie vom Proxycode verarbeitet wird.
  5. Der Anfragestrom wird über den Proxy fortgesetzt, bis eine Antwort an den Client zurückgegeben wird.

Mit Erweiterungen arbeiten

Jede Erweiterung wird mit Blick auf eine bestimmte externe Ressource entwickelt und konfiguriert. Um eine Erweiterung zu verwenden, führen ein Apigee Edge-Administrator und ein API-Proxy-Entwickler die folgenden Schritte aus:

  • Ein Organisationsadministrator von Apigee Edge konfiguriert und stellt die Erweiterung bereit. Er konfiguriert sie mit Werten, die speziell auf die Anforderungen des Unternehmens zugeschnitten sind. Durch diese Konfiguration wird eine Erweiterungsinstanz erstellt, die für die Verwendung durch den API-Proxy-Entwickler vorgesehen ist. Er kann beispielsweise eine Erweiterung für den Zugriff auf einen bestimmten Bucket in Google Cloud Storage konfigurieren, einschließlich der erforderlichen Authentifizierungsanmeldedaten.
  • Ein API Proxy-Entwickler verwendet eine konfigurierte Erweiterung in einem API-Proxy, indem er dem Proxy eine Extension Callout-Richtlinie hinzufügt. In der Konfiguration der Richtlinie wird Folgendes angegeben:
    • Welche konfigurierte Erweiterung verwendet werden soll.
    • Die zu aufrufenden Erweiterungsaktionen (stellen Sie sich diese als Funktionsaufrufe an die Erweiterung vor).
    • Die Aktionsparameter, die mit dem Aktionsaufruf übergeben werden sollen. Während der Laufzeit verwendet die Richtlinie die Erweiterung, um im Rahmen des Proxyablaufs auf die externe Ressource zuzugreifen.

Dokumentation zu Erweiterungen

In den folgenden Themen finden Sie weitere Informationen zu Erweiterungen: