Was sind Erweiterungen?

Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. info

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

Extension Runtime Framework

Zur Laufzeit fungiert eine Erweiterung als Vermittler und verarbeitet Anfragen und Antworten zwischen einem API-Proxy und einer externen Ressource.

Hier finden Sie eine Übersicht darüber, wie die Verarbeitung über eine Erweiterung zur Laufzeit funktioniert.

  1. Eine Clientanfrage erreicht einen API-Proxy und der Anfrageablauf wird durch die Richtlinien des Proxys geleitet.
  2. Der Anfrageablauf erreicht im Proxy eine Richtlinie für Zusatzinformationen zu Erweiterungen, 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 mit Proxycode verarbeitet wird.
  5. Der Anfragefluss 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 allgemeinen Schritte aus:

  • Ein Apigee Edge-Organisationsadministrator konfiguriert und implementiert die Erweiterung. Sie konfigurieren ihn mit Werten, die auf die Anforderungen des Unternehmens zugeschnitten sind. Mit dieser Konfiguration wird eine Erweiterungs-Instanz erstellt, die speziell für den API-Proxy-Entwickler verwendet wird. So kann beispielsweise eine Erweiterung für den Zugriff auf einen bestimmten Bucket in Google Cloud Storage konfiguriert werden, einschließlich der erforderlichen Authentifizierungsanmeldedaten.
  • Ein API-Proxy-Entwickler verwendet eine konfigurierte Erweiterung in einem API-Proxy, indem er dem Proxy eine Richtlinie für Erweiterungs-Callouts hinzufügt. In der Konfiguration der Richtlinie wird Folgendes angegeben:
    • welche konfigurierte Erweiterung verwendet werden soll.
    • die auszuführenden Erweiterungsaktionen (denken Sie dabei an Funktionsaufrufe an die Erweiterung).
    • die Aktionsparameter, die mit dem Aktionsaufruf übergeben werden sollen. Zur Laufzeit verwendet die Richtlinie die Erweiterung, um im Rahmen des Proxy-Ablaufs auf die externe Ressource zuzugreifen.

Dokumentation zu Erweiterungen

Weitere Informationen zu Erweiterungen finden Sie unter den folgenden Themen: