Informationen zu den unterstützten Connectors für Application Integration.

Aufgabe „Sperren“

Mit einer Sperraufgabe können Sie die Ausführung einer Integration vorübergehend anhalten und dann fortsetzen.

Wenn während der Ausführung einer Integration eine Sperraufgabe erreicht wird, wird die Ausführung angehalten. Alle Aufgaben, die der Sperraufgabe nachgelagert sind, werden ebenfalls angehalten. Apigee setzt die Ausführung fort, sobald eines der folgenden Ereignisse eintritt:

• Ablauf der angegebenen Sperrzeit.
• Eingehen einer Anfrage zur Wiederaufnahme der Ausführung von der Suspensions-API.

Sie können auch eine Ausgabevariable (Sperr-Ergebnis) für die Sperraufgabe konfigurieren und auf einen beliebigen Wert setzen. Mit dem Wert können Sie Verzweigungsbedingungen für die Ausführung der nachgelagerten Aufgaben erstellen.

Aufgaben „Genehmigung“, „Sperren“ und „Timer“ vergleichen

Alle drei Aufgaben (Genehmigung, Sperren und Timer) führen eine ähnliche Funktion zum Anhalten und Fortsetzen einer Integration aus. Es gibt jedoch geringfügige Unterschiede. In der folgenden Tabelle werden die Unterschiede zwischen den drei Aufgaben beschrieben.

Aufgabe „Genehmigung“	Aufgabe „Sperren“	Aufgabe "Timer"
Unterstützt die automatische Wiederaufnahme einer Integration nicht. Es ist ein manuelles Eingreifen erforderlich, um die Integration fortzusetzen.	Unterstützt die manuelle oder automatische Wiederaufnahme einer Integration. Erfolgt kein manueller Eingriff zum Widerruf der Sperrung, so wird die Integration nach Ablauf der Sperrzeit automatisch fortgesetzt.	Unterstützt nur die automatische Wiederaufnahme von Integrationen. Die Integration wird nach Ablauf des Sperrzeitlimits automatisch fortgesetzt.
Integrationen können nicht über API-Aufruf fortgesetzt werden. Sie müssen die Sperrung manuell über die Integrations-UI aufheben.	Kann eine Integration mit der Suspensions-API für Integrationen fortsetzen.	Unterstützt nur die automatische Wiederaufnahme von Integrationen.
Nutzer erhalten eine Benachrichtigung, wenn eine Integration pausiert (gesperrt) wird.	Nutzer erhalten keine Benachrichtigung, wenn eine Integration pausiert (gesperrt) wird.	Nutzer erhalten keine Benachrichtigung, wenn eine Integration pausiert (gesperrt) wird.
Unterstützt eine Ausgabevariable (boolesch), mit der Sie bedingte Prüfungen durchführen können, bevor Sie eine Integration fortsetzen. Die Ausgabevariable darf jedoch nur die Werte true oder false haben.	Unterstützt eine Ausgabevariable (String), mit der Sie bedingte Prüfungen durchführen können, bevor Sie eine Integration fortsetzen. Sie können einen beliebigen Wert für die Ausgabevariable festlegen.	Unterstützt keine Ausgabevariablen.

Sperraufgabe konfigurieren

Führen Sie die folgenden Schritte aus, um die Aufgabe Sperren zu konfigurieren:

1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

   Zur Seite „Application Integration“

2. Klicken Sie im Navigationsmenü auf Integrations (Integrationen).

   Die Seite Integrationen wird angezeigt. Dort sind alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.

3. Wähle eine vorhandene Integration aus oder klicke auf Verknüpfung erstellen, um eine neue zu erstellen.

   Wenn Sie eine neue Integration erstellen:

   1. Geben Sie im Bereich Create Integration (Integration erstellen) einen Namen und eine Beschreibung ein.
   2. Wählen Sie eine Region für die Integration aus.
      Hinweis: Im Drop-down-Menü Regionen werden nur die in Ihrem Google Cloud-Projekt bereitgestellten Regionen aufgeführt. Klicken Sie zum Bereitstellen einer neuen Region auf Region aktivieren. Weitere Informationen finden Sie unter Neue Region aktivieren.
   3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit in der Integrationsübersicht in der Integrationssymbolleiste ändern oder aktualisieren.
      Hinweis:Die Option zur Auswahl eines Dienstkontos wird nur angezeigt, wenn Sie die Integration Governance für die ausgewählte Region aktiviert haben.
   4. Klicken Sie auf Erstellen.

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

4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Tasks, um die Liste der verfügbaren Aufgaben aufzurufen.
5. Klicken Sie auf das Aufgabenelement Sperren und platzieren Sie es im Integrationseditor.
6. Klicken Sie im Designer auf das Element der Sperraufgabe, um den Konfigurationsbereich für Sperraufgaben aufzurufen.
7. Konfigurieren Sie die übrigen Felder mit den Konfigurationsattributen für die Aufgabe, wie in folgenden Tabellen beschrieben.

   Alle Änderungen an den Eigenschaften werden automatisch gespeichert.

Konfigurationsattribute

In der folgenden Tabelle werden die Konfigurationseigenschaften der Anhalten-Aufgabe beschrieben.

Attribut	Datentyp	Beschreibung
Suspension Time	Integer	Zeit (in Minuten), bis zu der die Integrationsausführung angehalten werden muss. Das maximale Zeitlimit beträgt 44640 Minuten (31 Tage), was auch der Standardwert ist. Wenn die Integrationsausführung nach Ablauf des Zeitlimits nicht fortgesetzt wird, wird sie automatisch fortgesetzt und der Wert der Variablen Suspension result auf Expired gesetzt.
Suspension result	String	Eine Variable zum Speichern des Ergebnisses der Sperraufgabe. Das Festlegen des Werts auf diese Variable ist optional. Sie können diese Variable gemäß Ihren Anforderungen auf einen beliebigen Wert setzen. Diese Variable ist nützlich, wenn Sie mehr Kontrolle über den Ausführungsablauf Ihrer Integration haben möchten. Sie können beispielsweise das Sperrergebnis lesen und bedingte Entscheidungen basierend auf dem Wert einer Ihrer nachgelagerten Aufgaben konfigurieren.
Suspension Id	String	Eindeutige Kennung für die Sperraufgabe. Der Wert dieser Variable wird unmittelbar nach dem Aussetzen der Integration festgelegt. Sie können den ID-Wert der Sperraufgabe auf der Seite Ausführungslogs in der Integrations-UI abrufen. Sie können den ID-Wert der Sperraufgabe auch aus dem Antwortobjekt einer API abrufen, wenn Sie eine API verwenden, um die Integration auszulösen. Sie können die Integrationsausführung mithilfe der Sperr- oder der Ausführungs-ID der Integration fortsetzen.

Sperrung mit der Sperr-API widerrufen

Mit der Sperr-API können Sie eine Sperrung über einen API-Aufruf widerrufen. Wenn Sie eine Sperrung mit der Sperr-API widerrufen möchten, benötigen Sie entweder die Ausführungs-ID der Integration oder die Sperr-ID der Sperraufgabe. Um eine Sperrung zu widerrufen, müssen Sie eine POST-Anfrage an folgende API senden:

https://REGION-integrations.googleapis.com/v1/{name=projects/PROJECT/locations/LOCATION/integrations/INTEGRATION_ID/executions/EXECUTION_ID/suspensions/SUSPENSION_ID}:lift
    

In dieser API ist die Angabe der INTEGRATION_ID optional. Sie müssen jedoch entweder die EXECUTION_ID oder die SUSPENSION_ID angeben. Wenn Sie keinen der ID-Werte haben, können Sie den Wert durch - ersetzen. In dieser API sind REGION, PROJECT und LOCATION Pflichtfelder.

Hinweis:

• Wenn Sie weder die Ausführungs- noch die Sperr-ID angeben, wird die API nicht ausgeführt und meldet einen Fehler.
• Wenn Sie den suspension_result nicht angeben, wird der Wert des Sperr-Ergebnisses auf Resolved gesetzt.

Nachdem Sie die Sperrung aufgehoben haben, wird die Ausführung der Integration fortgesetzt und alle nachgelagerten Aufgaben nach der angehaltenen Aufgabe werden ausgeführt.

Die folgenden Beispiele zeigen, wie Sie eine Sperrung mithilfe der Sperr-API widerrufen.

Beispiel 1: Sperrung nur mit der Sperr-ID aufheben

Der folgende curl-Befehl zeigt, wie Sie eine Sperrung widerrufen, wenn Sie nur die Sperr-ID haben:

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"Approved"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/-/suspensions/c6a13a79-a918-41e2-82b9-32b5a010755a:lift

In diesem Beispiel wird die Suspension result-Variable für die Sperr-ID c6a13a79-a918-41e2-82b9-32b5a010755a auf Approved gesetzt.

Beispiel 2: Sperrung nur mit der Ausführungs-ID widerrufen

Der folgende curl-Befehl zeigt, wie Sie eine Sperrung widerrufen können, wenn Sie nur die Ausführungs-ID haben:

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"true"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/76a391e7-c801-45d7-8046-eab20d167ec5/suspensions/-:lift

In diesem Beispiel ist die Suspension result-Variable für die Ausführungs-ID 76a391e7-c801-45d7-8046-eab20d167ec5 auf true festgelegt.

Beispiel 3: Sperrung mit Ausführungs-ID und Sperr-ID aufheben

Der folgende curl-Befehl zeigt, wie Sie eine Sperrung widerrufen, wenn Sie sowohl die Ausführungs- als auch die Sperr-ID haben:

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"{processname: "Release", owner: "John", status: "approved"};"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/9b721baa-0a23-4576-b2b6-d251d163ea6f/suspensions/f01815bf-ed18-4e01-9d41-cc2ce7861e95:lift

In diesem Beispiel ist für die Suspension result-Variable für die Sperr-ID f01815bf-ed18-4e01-9d41-cc2ce7861e95 auf {processname: "Release", owner: "John", status: "approved"}; festgelegt.

Fehlerbehebungsstrategie

Eine Strategie zur Fehlerbehandlung für eine Aufgabe legt die Aktion fest, die ausgeführt werden soll, wenn die Aufgabe aufgrund eines temporären Fehlers fehlschlägt. Informationen zur Verwendung einer Fehlerbehandlungsstrategie und zu den verschiedenen Arten von Fehlerbehandlungsstrategien finden Sie unter Strategien zur Fehlerbehebung.