Integrationen hochladen und herunterladen

Sie können Ihre Integrationen als JSON-Datei herunterladen und in Ihrem lokalen System speichern. Daher ist Ihre gesamte Integration in einer Datei verfügbar, die Sie ohne Änderungen direkt in ein anderes Integrationsprojekt hochladen können. Durch das Hochladen einer Integration wird eine neue Version der Integration in dem Projekt erstellt, in das die Datei hochgeladen wird.

Eine vollständige Integration in einem Dateiformat zu haben, bietet folgende Vorteile:
  • Sie können die Integration ohne großen Aufwand von einem Projekt in ein anderes kopieren.
  • Sie können die Integrationsdatei programmatisch für sich wiederholende Änderungen aktualisieren, z. B. um Aufgaben umzubenennen oder Variablennamen dynamisch zu ändern.

Integration herunterladen

Führen Sie die folgenden Schritte aus, um eine Integration herunterzuladen:

  1. Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
  2. Klicken Sie auf Entwickeln > Integrationen.
  3. Wählen Sie eine vorhandene Integration aus. Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.
  4. Klicken Sie auf das Drop-down-Menü Versionen und wählen Sie die Version aus, die Sie herunterladen möchten.
  5. Klicken Sie in der Symbolleiste „Designer“ auf (Aktionsmenü) und wählen Sie Herunterladen aus.

    Die Datei „INTEGRATION_NAME.json“ wird automatisch im Standardordner Ihres Webbrowsers für Downloads gespeichert.

Integration hochladen

Führen Sie die folgenden Schritte aus, um eine Integration hochzuladen:

  1. Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
  2. Klicken Sie auf Entwickeln > Integrationen.
  3. Wählen Sie eine vorhandene Integration aus oder erstellen Sie eine neue Integration, indem Sie auf Integration erstellen klicken.

    Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

    1. Geben Sie im Dialogfeld Integration erstellen einen Namen und eine Beschreibung ein.
    2. Wählen Sie eine Region für die Integration aus.
    3. Klicken Sie auf Erstellen.

    Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.

  4. Klicken Sie in der Symbolleiste „Designer“ auf (Aktionsmenü) und wählen Sie Hochladen aus.
  5. Wählen Sie im Dateibrowser-Dialogfeld die Datei aus, die Sie hochladen möchten, und klicken Sie dann auf Öffnen.

    Eine neue Version der Integration wird mit der hochgeladenen Datei erstellt.

Download und Upload mit API

Sie können die Apigee-Integrations-APIs verwenden, um eine Integration hoch- oder herunterzuladen.

Integration mit API herunterladen

Um eine Integration herunterzuladen, senden Sie eine GET-Anfrage an die folgende API:
https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/products/apigee/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION:download

Das folgende Beispiel zeigt, wie Sie eine bestimmte Version einer Integration herunterladen:

curl -v -s \
-H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
-H "X-GFE-SSL: yes" \
-X GET "https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/products/apigee/integrations/test-integration/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11:download"

Weitere Informationen zu projects.locations.products.integrations.versions.download.

Integration mit API hochladen

Zum Hochladen einer Integration senden Sie eine POST-Anfrage an die folgende API: 
  https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/products/apigee/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION}:upload

Das folgende Beispiel zeigt, wie Sie eine Integration hochladen:

curl -v -s -H "Content-Type: application/json"  -H "Authorization: Bearer $TOKEN"  \
-X POST -d '{"content":
  "{\"name\":\"projects/450954726404/locations/us-east1/products/apigee/integrations/test-workflow/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11\",
  \"origin\":\"UI\",
  \"snapshotNumber\":\"3\",
  \"updateTime\":\"2022-01-06T04:26:58.137Z\",
  \"lockHolder\":\"abc@test.com\",
  \"createTime\":\"2022-01-06T04:26:42.734Z\",
  \"lastModifierEmail\":\"abc@test.com\",
  \"state\":\"DRAFT\",
  \"triggerConfigs\":[{\"label\":\"API Trigger\",\"startTasks\":[{\"taskId\":\"1\"}],
  \"properties\":{\"Trigger name\":\"rj-test-workflow_API_1\"},\"triggerType\":\"API\",\"triggerNumber\":\"1\",\"triggerId\":\"api_trigger/rj-test-workflow_API_1\"}],\"taskConfigs\":[{\"task\":\"EmailTask\",\"taskId\":\"1\",\"taskExecutionStrategy\":\"WHEN_ALL_SUCCEED\",\"displayName\":\"Send Email\"}]}"}'
  \https://integrations.googleapis.com/v1/projects/apigee-1/locations/us-east1/products/apigee/integrations/test-integration/versions:upload

Weitere Informationen zur API finden Sie unter projects.locations.products.integrations.versions.upload.

Hinweise

Beachten Sie bei der Verwendung des Features zum Hochladen oder Herunterladen Folgendes:

  • Durch das Hochladen einer Integration wird eine neue Version der Integration erstellt. Wenn Sie beispielsweise eine Integration mit dem Namen IP-Test in der Version 5 haben und eine Integrationsdatei in IP-Test hochladen, wird eine neue Version 6 für die Integration erstellt.
  • Wenn Sie keine bestehende Integration haben, in die Sie eine Datei hochladen können, müssen Sie zuerst eine neue Integration erstellen und dann die Datei hochladen. In diesem Fall hat die neu erstellte Integration die Version 1 und die hochgeladene Integration die Version 2.
  • Details zu Authentifizierungsprofilen, die für eine Integration konfiguriert sind, sind in der heruntergeladenen Datei nicht verfügbar. Nach dem Hochladen der Datei müssen Sie die Authentifizierungsprofile in der hochgeladenen Integration neu konfigurieren.