Informationen zu den unterstützten Connectors für die Anwendungsintegration.

Cloud Scheduler-Trigger

Mit dem Cloud Scheduler-Trigger können Sie die Integrationsausführungen für definierte Zeiträume oder regelmäßige Intervalle in mehreren Regionen planen.

Cloud Scheduler-Trigger nutzen die Cloud Scheduler-Dienste, um innerhalb von Application Integration einen vollständig verwalteten Cronjob-Planer für Unternehmen bereitzustellen. Mit diesem Trigger können Sie jetzt alle Cronjobs, die in Ihrer Integration erstellt wurden, sowohl über die Application Integration-UI als auch über das Cloud Scheduler-Dashboard verwalten. Darüber hinaus können Sie mit dem Cloud Scheduler-Trigger auch regionenübergreifende Cronjobs bereitstellen, um die Integrationsausführungen zu planen.

Wenn Sie beispielsweise die Integration in us-central1 bereitgestellt haben, können Sie mit dem Cloud Scheduler-Trigger einen Cronjob in asia-east1 (oder einem der unterstützten Google Cloud-Regionen für Cloud Scheduler) bereitstellen, um den Endpunkt Ihrer Integration unter us-central1 aufzurufen.

Wichtig: Für die Nutzung der Cloud Scheduler-Dienste in Ihrer Integration fallen gesonderte Gebühren an. Die Gebühren richten sich nach der Anzahl der Cronjobs, die mit dem Cloud Scheduler-Trigger in Application Integration erstellt wurden. Weitere Informationen zu den Cloud Scheduler-Gebühren finden Sie unter Cloud Scheduler-Preise.

Hinweis

Führen Sie die folgenden Aufgaben in Ihrem Google Cloud-Projekt aus, bevor Sie den Cloud Scheduler-Trigger konfigurieren:

1. Cloud Scheduler API aktivieren (cloudscheduler.googleapis.com).

   Cloud Scheduler API aktivieren

2. Prüfen Sie, ob Sie ein Google-Dienstkonto mit der zugewiesenen Rolle Application Integration Invoker haben. Wenn Sie noch kein Dienstkonto haben, müssen Sie ein neues erstellen und ihm die Rolle Aufrufer der Anwendungsintegrationen zuweisen.

   Informationen zum Erstellen und Verwalten von Dienstkonten finden Sie unter Dienstkonten erstellen und verwalten.

   Informationen zu den vordefinierten Rollen für Application Integration finden Sie unter Vordefinierte IAM-Rollen.

Cloud Scheduler-Trigger hinzufügen

Führen Sie folgende Schritte aus, um der Integration einen Cloud Scheduler-Trigger hinzuzufügen:

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 Liste der Integrationen wird angezeigt. Dort sind alle Integrationen aufgeführt, die im Google Cloud-Projekt verfügbar sind.

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 Details des Dienstkontos einer Integration jederzeit im Bereich Integrationsübersicht in der Symbolleiste für Integrationen ä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.

4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
5. Klicken Sie auf das Element Cloud Scheduler-Trigger und platzieren Sie es im Integrationseditor.

Cloud Scheduler-Trigger konfigurieren

So konfigurieren Sie einen Cloud Scheduler-Trigger:

1. Klicken Sie im Integrationseditor auf das Element Cloud Scheduler-Trigger, um den Bereich mit der Triggerkonfiguration zu öffnen.

   Geben Sie den Zeitplan des Cloud Scheduler-Triggers mit einer der folgenden Optionen an:

   • Basic: Verwenden Sie die Benutzeroberfläche, um den Cronjob-Zeitplan zu konfigurieren.
   • Erweitert: Verwenden Sie einen unix-cron-Ausdruck, um den Cronjob-Zeitplan zu konfigurieren.
2. Wählen Sie bei der Option „Einfach“ den Tab Basic aus und gehen Sie folgendermaßen vor:
   1. Zeiten: Wählen Sie die Zeitintervalle aus, in denen die Integration ausgeführt werden muss.
      • Ausführung zu einem bestimmten Zeitpunkt: Wählen Sie diese Option aus, um die Integration zu einem bestimmten Zeitpunkt auszuführen.
      • Wiederholung nach Stunde: Wählen Sie diese Option aus, um die Integration wiederholt pro Stunde auszuführen.
      • Wiederholung nach Minute: Wählen Sie diese Option aus, um die Integration gemäß der angegebenen Anzahl von Minuten wiederholt auszuführen.
   2. Tage: Wählen Sie die Tage, an denen die Integration ausgeführt werden soll. Sie können die Integration täglich, an bestimmten Wochentagen oder an einem bestimmten Tag im Monat ausführen.
   3. Monate: Wählen Sie den/die Monat(e), in dem/denen die Integration ausgeführt werden muss. Sie können die Integration jeden Monat oder nur in bestimmten Monaten ausführen.
3. (Für die Option „Erweitert“) Wählen Sie den Tab Erweitert aus und geben Sie mit einem Cron-Ausdruck den Zeitplan des Cronjobs an.

   Der Cron-Ausdruck umfasst fünf Werte, die in der folgenden Reihenfolge angegeben werden müssen:

   1. Minute (0–59)
   2. Stunde (0–23)
   3. Tag des Monats (1–31)
   4. Monat (einer der folgenden Werte):
      • Eine Zahl (1–12)
      • Eine aus drei Buchstaben bestehende monatliche Abkürzung (z. B. Januar, Februar, März)
   5. Wochentag (einer der folgenden Werte):
      • Zahl von 0–6, beginnend mit Sonntag als 0
      • Eine Abkürzung aus drei Buchstaben (z. B. Mon, Die, Mit usw.)

   Wenn Sie beispielsweise die Integration am ersten Tag jedes Monats ausführen möchten, verwenden Sie den Cron-Ausdruck * * 1 * *.

   Weitere Informationen finden Sie unter Zeitpläne für Cronjobs konfigurieren.

4. Region: Wählen Sie die Region aus, in der Ihr Cloud Scheduler-Job bereitgestellt werden soll.
5. E-Mail-Adresse des Dienstkontos: Geben Sie die E-Mail-Adresse des erstellten Google-Dienstkontos ein.

Trigger-Ausgabe

Für jeden Cloud Scheduler-Trigger, der in Ihrer Integrationsversion konfiguriert und veröffentlicht wird, erstellt Application Integration in Ihrem Google Cloud-Projekt einen neuen Cloud Scheduler-Job.

Ein Cloud Scheduler-Job wird mit der folgenden Namenskonvention erstellt, um Fehler bei der Jobduplizierung zu vermeiden:

    INTEGRATION_NAME__VINTEGRATION_VERSION__CLOUD_SCHEDULER_TRIGGER_NUMBER
    

Beispiel: DemoIntegration__V1__1

Trigger-Logs

Ein Cloud Scheduler-Trigger generiert am Anfang und Ende jeder Integrationsausführung Logs. Sie können die Logs des Cloud Scheduler-Triggers auf der Seite Log-Explorer von Cloud Logging aufrufen:

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

   Zu Cloud Scheduler

2. Suchen Sie Ihren Cloud Scheduler-Job und klicken Sie in der Spalte Logs auf Ansehen.

   Auf der Seite Cloud Logging-Log-Explorer werden die vom Cloud Scheduler-Trigger generierten Logs angezeigt.

Hinweis: Die Anwendungsintegration speichert oder erfasst keine vom Cloud Scheduler-Trigger generierten Logs. Diese Logs werden in Ihrem Google Cloud-Projekt gespeichert und können nur auf der Seite Log-Explorer von Cloud Logging aufgerufen werden.

Cloud Scheduler-Trigger bearbeiten

Application Integration

Warnung:Wenn Sie einen Cloud Scheduler-Trigger in Application Integration bearbeiten, wird der vorhandene Cronjob mit einem neuen Cronjob in einer neuen Integrationsversion überschrieben.

Führen Sie die folgenden Schritte aus, um Ihren Cloud Scheduler-Trigger über Application Integration zu bearbeiten:

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

   Zu „Application Integration“

2. Klicken Sie im Navigationsmenü auf Integrations (Integrationen). Die Seite Integrationen wird angezeigt.
3. Wählen Sie die Integrationen aus, die getestet werden sollen.
4. Klicken Sie im Integrationseditor auf das Drop-down-Menü Version und wählen Sie die Integrationsversion aus, die den Cloud Scheduler-Trigger enthält, den Sie bearbeiten möchten.
5. Heben Sie die Veröffentlichung auf und aktivieren Sie die Bearbeitung, wenn die ausgewählte Integrationsversion veröffentlicht ist (im aktiven Status).
6. Klicken Sie im Integrationseditor auf das Element Cloud Scheduler-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
7. Ändern Sie die Cloud Scheduler-Jobkonfigurationen nach Bedarf.

Cloud Scheduler

Sie können Ihren Cloud Scheduler-Trigger bearbeiten, indem Sie die Konfiguration Ihres Cloud Scheduler-Jobs in Cloud Scheduler ändern:

1. Rufen Sie in der Google Cloud Console Cloud Scheduler auf.

   Zu Cloud Scheduler

2. Wählen Sie den zu bearbeitenden Cloud Scheduler-Job aus.
3. Klicken Sie auf Bearbeiten.
4. Ändern Sie die Cloud Scheduler-Jobkonfigurationen nach Bedarf.

Hinweis: Wenn Sie einen Cloud Scheduler-Job in Cloud Scheduler bearbeiten, ändert sich der Status der Zielintegrationsversion nicht.

Anhalten, Fortsetzen, Kopieren eines Cloud Scheduler-Jobs

Die Anwendungsintegration unterstützt keine Vorgänge zum Anhalten, Fortsetzen und Kopieren für einen Cloud Scheduler-Job, der mit dem Cloud Scheduler-Trigger erstellt wurde.

Der Cloud Scheduler-Trigger gibt im Triggerkonfigurationsbereich einen Fehler aus, wenn Sie die Ausführung eines Cloud Scheduler-Jobs über Cloud Scheduler manuell pausieren.

Weitere Informationen zu Fehlermeldungen beim Cloud Scheduler-Trigger finden Sie unter Fehlerbehebung bei Cloud Scheduler-Triggern. Informationen zum Anhalten und Fortsetzen eines Cronjobs mit Cloud Scheduler finden Sie unter Job anhalten oder fortsetzen.

Cloud Scheduler-Job löschen

Sie können einen Cloud Scheduler-Job entweder über Ihre Integration in Application Integration oder über Cloud Scheduler löschen.

Application Integration

So löschen Sie einen Cloud Scheduler-Job aus der Anwendungsintegration:

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

   Zu „Application Integration“

2. Klicken Sie im Navigationsmenü auf Integrations (Integrationen). Die Seite Integrationen wird angezeigt.
3. Wählen Sie die Integrationen aus, die getestet werden sollen.
4. Klicken Sie im Integrationseditor auf das Drop-down-Menü Version und wählen Sie die Integrationsversion aus, die den Cloud Scheduler-Trigger enthält, den Sie löschen möchten.
5. Veröffentlichung der ausgewählten Integrationsversion aufheben

   Der Cloud Scheduler-Job für die entsprechende Integrationsversion wird gelöscht.

Cloud Scheduler

So löschen Sie einen Cloud Scheduler-Job aus Cloud Scheduler:

1. Rufen Sie in der Google Cloud Console Cloud Scheduler auf.

   Zu Cloud Scheduler

2. Wählen Sie den zu löschenden Cloud Scheduler-Job aus.
3. Klicken Sie auf Löschen.

   Der Cloud Scheduler-Job für die entsprechende Integrationsversion wird gelöscht.

Hinweis:

• Wenn Sie einen Cloud Scheduler-Job aus Cloud Scheduler löschen, wird der Cloud Scheduler-Trigger in Ihrer Integration in Application Integration nicht gelöscht.
• Der Cloud Scheduler-Trigger in Ihrer Integration gibt im Triggerkonfigurationsbereich einen Fehler aus, wenn ein Cloud Scheduler-Job mit Cloud Scheduler gelöscht wird. Weitere Informationen zu Fehlermeldungen beim Cloud Scheduler-Trigger finden Sie unter Fehlerbehebung bei Cloud Scheduler-Triggern.

Best Practices

Als Best Practice sollten Sie die Veröffentlichung aller Cloud Scheduler-Trigger aufheben, wenn sie nicht mehr benötigt werden. Wenn Sie einen redundanten Cloud Scheduler-Trigger veröffentlicht lassen, ruft der Trigger die Integration weiterhin automatisch auf, was zu zusätzlichen Abrechnungsgebühren führen kann.

Fehlerbehebung beim Cloud Scheduler-Trigger

In der folgenden Tabelle werden die Fehler beschrieben, die beim Cloud Scheduler-Trigger auftreten können, und die zugehörigen Ursachen.

Fehlerposition	Vorkommen des Fehlers	Fehlermeldung	Mögliche Ursachen	Lösung
Bereich für die Triggerkonfiguration > Fehlermeldung	Wenn der Cloud Scheduler-Job die Ausführung Ihrer Integration beendet	The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB doesn’t exist. It might be deleted from your Google Cloud project.	Der Cloud Scheduler-Job wird mit Cloud Scheduler gelöscht.	Erstellen Sie eine neue Integrationsversion, um den vorhandenen Cloud Scheduler-Job zu überschreiben.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is PAUSED. You must RESUME the job from your Google Cloud project.	Der Cloud Scheduler-Job wird mit Cloud Scheduler pausiert.	Fortsetzen des Cloud Scheduler-Jobs über Cloud Scheduler.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is DISABLED due to an internal system error.	Prüfen Sie die Triggerlogs, um das Problem zu identifizieren.	Erstellen Sie eine neue Integrationsversion, um den vorhandenen Cloud Scheduler-Job zu überschreiben.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is in an UPDATE_FAILED state due to a failed CloudScheduler.UpdateJob operation.	Das angegebene Dienstkonto hat nicht die erforderlichen IAM-Berechtigungen.	Zum Wiederherstellen eines Jobs aus diesem Status wiederholen Sie den CloudScheduler.UpdateJob-Vorgang, bis eine erfolgreiche Antwort empfangen wird.
		The last execution of the Cloud Scheduler job CLOUD_SCHEDULER_JOB failed due to CLOUD_SCHEDULER_JOB_ISSUE. Learn more.	CLOUD_SCHEDULER_JOB_ISSUE	–

SLA-Ausschlüsse

Der Cloud Scheduler-Trigger ist vom Produkt Cloud Scheduler abhängig. Da diese Abhängigkeit außerhalb von Application Integration liegt, ist die Application Integration Service Level Agreement (SLA) gelten nur, wenn die Die Ausführung wurde für eine active-Integration geplant.