Aufgabe „Genehmigung“

Mit der Aufgabe Genehmigung können Sie integrationsbasierte Integrationen konfigurieren. Außerdem können Sie den Ablauf einer Integration steuern.

Sie können die Genehmigungsaufgabe verwenden, um E-Mails für Genehmigungsanfragen an einen oder mehrere Integrationsnutzer zu senden. Die E-Mail enthält einen Link zur Integration, über den die Nutzer die Anfrage manuell genehmigen oder ablehnen können.

Wenn während der Ausführung einer Integration die Genehmigungsaufgabeerreicht wird, wird die Ausführung angehalten. Alle Aufgaben, die der Genehmigungsaufgabenachgelagert sind, werden angehalten. Die Integration wird erst dann wieder ausgeführt, wenn ein Nutzer die Genehmigungsanfrage entweder in der Google Cloud Console oder über die API genehmigt oder ablehnt.

Eine Genehmigungsaufgabe kann für folgende Zwecke verwendet werden:

• Sie können eine Integration basierend auf der Genehmigung oder Ablehnung des Nutzers sperren und verzweigen.
• Sie können eine Integration bis zu einer bestimmten Dauer sperren.
• Sie können die Aufgabe als Haltepunkt bei der Fehlerbehebung der Integration verwenden.

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"
Wird fortgesetzt, wenn ein Nutzer die Anfrage in der Integrations-UI oder über die API genehmigt oder ablehnt.	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.
Kann eine Integration über die Integrations-UI oder durch Aufrufen der Methode suspensions.resolve fortsetzen. Weitere Informationen finden Sie unter Über die API genehmigen oder ablehnen.	Kann eine Integration durch Aufrufen der Methode suspensions.lift 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.

Aufgabe „Genehmigung“ konfigurieren

So konfigurieren Sie die Aufgabe „Genehmigung“:

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

   Zu Application Integration

2. Klicken Sie im Navigationsmenü auf Integrationen.

   Die Seite Integrationen wird geöffnet. Dort werden alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.

3. 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 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 im Bereich Integrationsübersicht in der Integrationssymbolleiste ändern oder aktualisieren.
      Hinweis: Die Option zum Auswählen eines Dienstkontos wird nur angezeigt, wenn Sie die Integrations-Governance für die ausgewählte Region aktiviert haben.
   4. Klicken Sie auf Erstellen. Die neu erstellte Integration wird im Integrationseditor geöffnet.

4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Aufgaben, um die Liste der verfügbaren Aufgaben und Connectors aufzurufen.
5. Klicken Sie auf das Aufgabenelement Genehmigung und platzieren Sie es im Integrationseditor.
6. Klicken Sie im Designer auf das Aufgabenelement Genehmigung, um den Konfigurationsbereich der Genehmigungsaufgabe zu öffnen.
7. Konfigurieren Sie die angezeigten Felder mithilfe der Konfigurationsattribute für die Aufgabe, wie in der folgenden Tabelle beschrieben.

   Ihre Änderungen an den Attributen werden automatisch gespeichert.

Konfigurationsattribute

In folgender Tabelle werden die Konfigurationsattribute der Genehmigungsaufgabe beschrieben.

Attribut	Datentyp	Beschreibung
Recipients	String-Array	E-Mail-Adressen, an die Benachrichtigungen gesendet werden, wenn die Aufgabe gesperrt ist. Geben Sie mehrere E-Mail-Adressen durch Kommas getrennt ein. Hinweis: In Ihrem Google Cloud-Projekt müssen Sie allen unter Empfänger angegebenen E-Mail-Adressen die IAM-Rolle Application Integration Approver zuweisen. Eine Anleitung zum Zuweisen von IAM-Rollen finden Sie unter Zugriff auf Ressourcen erteilen, ändern und entziehen.
Custom notification message	String	Benutzerdefinierte Nachricht, die in die E-Mail-Benachrichtigung aufgenommen werden soll, wenn die Aufgabe gesperrt wird. Der Wert kann ein Literal oder eine Variable sein. Wenn die benutzerdefinierte Nachricht in einer Variablen verfügbar ist, klicken Sie auf VAR und wählen Sie die Variable aus.
Reminder frequency (in hours)	Integer	Häufigkeit der Erinnerungsbenachrichtigungen. Wenn die Sperrung nicht aufgehoben ist, können Sie E-Mail-Benachrichtigungen senden, mit denen autorisierte Nutzer aufgefordert werden, die Sperrung aufzuheben.
Time until expiration (in hours)	Integer	Der Zeitraum der Sperrung. Wenn die Sperrung nicht innerhalb der Frist aufgehoben wird, wird sie standardmäßig abgelehnt.
On expiration	Boolesch	Aktion, die nach Ablauf der Sperrung ausgeführt werden soll. Sie können auswählen, ob die Sperrung abgelehnt oder aufgehoben werden soll. Standardmäßig wird die Sperrung abgelehnt.
isApproved (Approval)	Boolesch	Ausgabevariable mit dem Status der Sperrung nach der Auflösung. Die Variable isApproved wird auf True festgelegt, wenn die Sperrung genehmigt wurde, und auf False, falls sie abgelehnt wurde. Tipp: Verwenden Sie die Variable isApproved, wenn Sie Edge-Bedingungen für nachfolgende Aufgaben angeben, um den Integrationsablauf zu steuern. Weitere Informationen zu Edge-Bedingungen finden Sie unter Edge-Bedingungen. Das folgende Beispiel zeigt eine Edge-Bedingung, die mit der isApproved-Variable konfiguriert wird: $TASK_ID_isApproved$ = TRUE

Über die API auf eine Genehmigungsanfrage antworten

Wenn Sie eine ausstehende Genehmigungsanfrage ohne die Google Cloud Console genehmigen oder ablehnen möchten, rufen Sie die Methode projects.locations.integrations.executions.suspensions.resolve auf.

Zum Genehmigen oder Ablehnen einer Anfrage benötigen Sie die Berechtigung integrations.suspensions.resolve. Zum Auflisten von Sperrungen benötigen Sie außerdem die Berechtigung integrations.suspensions.list. Die Rolle „Application Integration Approver“ (roles/integrations.suspensionResolver) enthält beide Berechtigungen, ebenso wie die Rolle „Application Integration Admin“ (roles/integrations.integrationAdmin).

Wenn die Integration ein Run-as-Dienstkonto verwendet, weisen Sie diesem Dienstkonto die Rolle „Dienstkontonutzer“ (roles/iam.serviceAccountUser) zu. Diese Anforderung tritt in Kraft, wenn die unter Dienstkontonutzer gewähren beschriebene Einführung fortgesetzt wird.

1. Wenn Sie die ausstehende Anfrage finden möchten, listen Sie die Sperrungen der Ausführung mit der Methode projects.locations.integrations.executions.suspensions.list auf:

   curl -X GET \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       "https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions/EXECUTION_ID/suspensions"
   

   Suchen Sie in der Antwort nach der Sperrung, deren taskId die ID Ihrer Genehmigungsaufgabe ist und deren state PENDING ist. Die Antwort enthält auch Sperrungen von Sperraufgaben und anderen Genehmigungsaufgaben in derselben Ausführung. Notieren Sie sich den name der Sperrung, der mit der Sperrungs-ID endet.

2. Rufen Sie die Methode suspensions.resolve auf, um die Anfrage zu genehmigen oder abzulehnen:

   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json" \
       -d '{
         "suspension": {
           "eventExecutionInfoId": "EXECUTION_ID",
           "integration": "INTEGRATION_NAME",
           "taskId": "TASK_ID",
           "state": "STATE"
         }
       }' \
       "https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions/EXECUTION_ID/suspensions/SUSPENSION_ID:resolve"
   

Ersetzen Sie Folgendes:

• PROJECT_ID: Die ID Ihres Google Cloud -Projekts.
• LOCATION: Die Region der Integration.
• INTEGRATION_NAME: Der Name der Integration.
• EXECUTION_ID: Die ID der gesperrten Ausführung.
• TASK_ID: Die ID der Genehmigungsaufgabe (die taskId der Sperrung).
• SUSPENSION_ID: Die Sperrungs-ID aus der name der Sperrung.
• STATE: Der Lösungsstatus. Verwenden Sie LIFTED, um die Anfrage zu genehmigen (isApproved wird auf true gesetzt), oder REJECTED, um sie abzulehnen (isApproved wird auf false gesetzt).

Hinweis:

• Wenn Sie eine neue Version der Integration veröffentlichen, werden die Ausführungen abgebrochen, die auf eine Genehmigung warten.
• Mit der Methode suspensions.lift wird eine Sperraufgabe fortgesetzt. Eine Genehmigungsaufgabe wird dadurch nicht genehmigt oder abgelehnt.

Fehlerbehandlungsstrategie

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.

Nächste Schritte

• Alle Aufgaben und Trigger.
• Hier erfahren Sie, wie Sie eine Integration testen und veröffentlichen.
• Weitere Informationen zur Fehlerbehandlung.
• Weitere Informationen zu Ausführungslogs der Integration.