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:

Rufen Sie in der Google Cloud Console die Seite Application Integration auf.
Zu Application Integration
Klicken Sie im Navigationsmenü auf Integrations (Integrationen).
Auf der Seite Integrationen werden alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.
Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Integration erstellen, um eine neue zu erstellen.
Wenn Sie eine neue Integration erstellen, gehen Sie so vor:
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 Symbolleiste der Verknüpfung im Bereich Integrationsübersicht ändern oder aktualisieren.
  Hinweis: Die Option zum Auswählen eines Dienstkontos wird nur angezeigt, wenn Sie die Integrationsverwaltung für die ausgewählte Region aktiviert haben.
4. Klicken Sie auf Erstellen.
Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.
Klicken Sie in der Navigationsleiste des Integrationseditors auf Aufgaben, um eine Liste der verfügbaren Aufgaben und Verbindungen aufzurufen.
Klicken Sie auf das Aufgabenelement Sperren und platzieren Sie es im Integrationseditor.
Klicken Sie im Designer auf das Element der Sperraufgabe, um den Konfigurationsbereich für Sperraufgaben aufzurufen.
Konfigurieren Sie die übrigen Felder mit den Konfigurationsattributen für die Aufgabe, wie in folgenden Tabellen beschrieben.
Ihre Änderungen an den Attributen werden automatisch gespeichert.

Konfigurationsattribute

In folgender Tabelle werden die Konfigurationsattribute der Sperraufgabe beschrieben.

Attribut	Datentyp	Beschreibung
`Suspension Time`	Ganzzahl	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. Wird die Ausführung der Integration innerhalb des angegebenen Zeitlimits nicht fortgesetzt, setzt Apigee die Ausführung nach Ablauf des Zeitlimits automatisch fort und setzt den Wert der `Suspension result`-Variable auf `Expired`.
`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 keine der ID-Werte haben, können Sie den Wert durch - ersetzen. In dieser API sind REGION, PROJECT und LOCATION Pflichtfelder.

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.

Kontingente und Limits

Weitere Informationen zu allen Kontingenten und Limits finden Sie unter Kontingente und Limits.