Erste Schritte: Apigee Integration und Apigee-Proxy-Integrationsziele

In dieser Anleitung erfahren Sie, wie Sie mit dem Apigee-Proxyassistenten einen Proxy mit einem Integrationsziel erstellen. Der Proxy verwendet eine API-Trigger-Referenz aus einer vorhandenen Integration, um die Abfolge der Schritte in der Integration zu initiieren.

In den folgenden Schritten wird beschrieben, wie Sie den Integrations-Zielproxy so konfigurieren, dass auf Aufruf eines Proxys eine erfolgreiche Integration ausgeführt wird.

Vorbereitung

  • Bestätigen Sie Ihre Apigee-Anmeldedaten und die Organisationsdetails. Diese Informationen sind erforderlich, um auf das Apigee Integration-Feature und den Proxy-Assistenten in der Apigee-UI zuzugreifen.
  • Erstellen und veröffentlichen Sie eine Integration mit einem API-Trigger und mindestens einer Aufgabe.
    • Wenn Sie noch keine Integration erstellt haben, die einen API-Trigger verwendet, führen Sie die Schritte unter Erste Schritte mit Apigee Integration aus.
    • Notieren Sie sich den Namen der von Ihnen erstellten Integration oder die vorhandene Integration, die Sie verwenden möchten, da dieser in einem späteren Schritt benötigt wird.
  • Erstellen Sie ein Google-Dienstkonto im dem Google Cloud-Projekt, in dem auch Ihre Apigee-Organisation erstellt wurde, und gehen Sie so vor:
    • Weisen Sie dem Dienstkonto die Aufrufer von Apigee-Integrationen-Rolle (roles/integrations.apigeeIntegrationInvokerRole) zu. Informationen zu den vordefinierten Apigee Integration-Rollen finden Sie unter Vordefinierte IAM-Rollen.
    • Erlauben Sie Ihrem Nutzerkonto (Hauptkonto), Dienstkonten mit der Berechtigung iam.serviceAccounts.actAs an Ressourcen anzuhängen. Informationen zu Dienstkontoberechtigungen finden Sie unter Rollen für die Dienstkontoauthentifizierung .

    Sie müssen dieses Dienstkonto angeben, wenn Sie den API-Proxy bereitstellen.

Apigee Integrations-Zielproxy erstellen

So erstellen Sie einen Integrations-Zielproxy in der Apigee-Benutzeroberfläche:

  1. Wechseln Sie zur Apigee-Benutzeroberfläche und melden Sie sich an.
  2. Wählen Sie Ihre Organisation im Drop-down-Menü oben links in der Benutzeroberfläche aus.
  3. Klicken Sie in der Hauptansicht auf API-Proxys.

    Alternativ können Sie im linken Navigationsmenü Develop > API-Proxies auswählen.

  4. Wählen Sie in der Drop-down-Liste Umgebung die Umgebung aus, in der Sie einen neuen API-Proxy erstellen möchten.
  5. Klicken Sie auf Neu erstellen.
  6. Wählen Sie in der Anzeige der Proxytypen Integrationsziel aus.

    Der Assistent zum Erstellen von Proxys wird gestartet.

  7. Geben Sie auf der Konfigurationsseite Proxy-Details die folgenden Details an:
    • Name: Geben Sie einen Namen für den Proxy ein.

      Proxynamen können alphanumerische Zeichen, Bindestriche und Unterstriche enthalten.

    • Basispfad: Wird automatisch basierend auf dem Proxynamen eingefüllt.

      Der Basispfad ist Teil der URL, die zum Senden von Anfragen an Ihre API verwendet wird. Apigee verwendet die URL, um eingehende Anfragen zuzuordnen und an den richtigen API-Proxy weiterzuleiten.

    • Beschreibung: (Optional) Geben Sie eine kurze Beschreibung des Proxys ein.

      Beispiel: Proxy test for Apigee Integration.

    • Integrationsregion: Wählen Sie die Region der Integration aus der Drop-down-Liste aus.
    • Integrationsziel: Wählen Sie den Namen des Integrationsziels aus der Drop-down-Liste aus. Beachten Sie, dass die Einträge in der Liste der Integrationsziele der ausgewählten Integrationsregion entsprechen.
    • Trigger: Wählen Sie den mit der Integration verknüpften API-Trigger aus der Drop-down-Liste aus.
    • Endpunkttyp: Wählen Sie Synchronisierung aus.
  8. Klicken Sie auf Next (Weiter).
  9. Übernehmen Sie auf der Konfigurationsseite Allgemeine Richtlinien die Standardauswahl und klicken Sie auf Weiter.
  10. Klicken Sie auf der Seite Zusammenfassung auf Erstellen.

    Ein Integrations-Zielproxy wurde erfolgreich erstellt.

Proxy bereitstellen

Führen Sie folgende Schritte aus, um den neu erstellten Proxy bereitzustellen:

  1. Wählen Sie in der Apigee-Benutzeroberfläche Entwickeln > API Proxys.

    Die Benutzeroberfläche enthält eine Liste der API-Proxys und deren Bereitstellungsstatus:

  2. Wählen Sie in der Drop-down-Liste Umgebung die Umgebung aus, in der Sie den API-Proxy bereitstellen möchten.

  3. Klicken Sie auf den kürzlich erstellten Proxy, den Sie bereitstellen möchten. Standardmäßig wird in der UI die Seite Übersicht angezeigt.

  4. Klicken Sie zum Bereitstellen der Änderungen zuerst auf Bereitstellen, um das Dialogfeld Bereitstellen aufzurufen.
  5. Geben Sie Folgendes ein:
    • Überarbeitung: Die Überarbeitungsnummer des Proxys, den Sie bereitstellen möchten.
    • Umgebung: Die Umgebung, in der Sie den Proxy bereitstellen möchten.
    • Dienstkonto: Das erstellte Dienstkonto für den Proxy.
  6. Klicken Sie auf Bereitstellen.

Die Benutzeroberfläche beginnt mit der Bereitstellung der ausgewählten Überarbeitung. Es kann bis zu einer Minute dauern, bis die Proxybereitstellung abgeschlossen ist.

Wenn der Proxy bereitgestellt wird, wird in der Spalte Status im Abschnitt Bereitstellungen ein grünes Symbol angezeigt, das zeigt, dass Überarbeitung 1 des Proxys bereitgestellt ist.

Integrations-Zielproxy testen

Führen Sie folgenden Befehl im Terminalfenster aus, um den Proxy aufzurufen und die Integration auszulösen: 

curl -v https://YOUR_ENV_GROUP_HOSTNAME/PROXY_NAME

Dabei ist YOUR_ENV_GROUP_HOSTNAME der Hostname für eine Umgebungsgruppe, die die Umgebung enthält, in der Ihr Proxy bereitgestellt wird.

Beispiele: 

curl -v https://my-org-prod.hybrid.e2e.apigeeks.net/my-proxy

Sie können prüfen, ob die Integration ausgelöst wurde, indem Sie den Proxy aufrufen:

  1. Öffnen Sie die Apigee-Benutzeroberfläche.
  2. Klicken Sie auf Entwickeln > Integrationen.
  3. Suchen Sie nach dem in den obigen Schritten erstellten Integrationstyp oder wählen Sie ihn aus und klicken Sie auf den Namen der Integration.
  4. Klicken Sie auf Logs.
  5. Prüfen Sie, ob für die ausgelöste Integration ein Ausführungslog vorhanden ist. Zum Aufrufen der Logdetails klicken Sie auf die Zeile, um die Ausführungsdetails zu maximieren.

Nutzlast der Proxyanfrage aktualisieren (optional)

Führen Sie die folgenden Schritte aus, um die Nutzlast der Proxy-Anfrage zu aktualisieren:

  1. Wählen Sie in der Apigee-Benutzeroberfläche Entwickeln > API-Proxys im linken Navigationsmenü aus.
  2. Klicken Sie auf den kürzlich erstellten Proxy.

    Standardmäßig zeigt die Benutzeroberfläche im Proxy-Editor den Tab Übersicht für diesen Proxy an.

  3. Klicken Sie auf den Tab Entwickeln.
  4. Wählen Sie im Bereich Navigator unter der Überschrift Richtlinien Integrationsanfrage festlegen aus.
  5. Entfernen Sie die Kommentare für den Block <Parameters> und geben Sie die Parameterdetails ein.

    Um einzelne Parameter anzugeben, verwenden Sie das Element <Parameter>. Verwenden Sie das Element <ParameterArray>, um Parameter-Arrays anzugeben.

  6. Klicken Sie auf Speichern.

Nächste Schritte

Sehen Sie sich das Designerlayout für die Integration an und machen Sie sich mit den verschiedenen Integrationskonzepten vertraut, die unter Alle Konzepte beschrieben werden.