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

Cloud Scheduler-Trigger

Mit dem Cloud Scheduler-Trigger können Sie die Integrationsausführungen für bestimmte Zeiträume oder regelmäßige Intervalle über mehrere Regionen hinweg planen.

Cloud Scheduler-Trigger nutzen die Cloud Scheduler-Dienste, um einen vollständig verwalteten Cronjob-Planer für Unternehmen in Application Integration bereitzustellen. Mit diesem Trigger können Sie jetzt alle Cronjobs verwalten, die innerhalb der Integration erstellt wurden, sowohl über die Application Integration-UI als auch über das Cloud Scheduler-Dashboard. Darüber hinaus können Sie mit dem Cloud Scheduler-Trigger auch regionsü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.

Hinweise

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

Aktivieren Sie die Cloud Scheduler API (cloudscheduler.googleapis.com).
Cloud Scheduler API aktivieren
Prüfen Sie, ob Sie ein Google-Dienstkonto mit der Rolle Application Integration Invoker haben. Wenn Sie kein Dienstkonto haben, müssen Sie ein neues erstellen und ihm die Rolle Application Integration Invoker zuweisen.
Informationen zum Erstellen und Verwalten von Dienstkonten finden Sie unter Dienstkonten erstellen und verwalten.

Informationen zu den vordefinierten Rollen von Application Integration finden Sie unter Vordefinierte IAM-Rollen.

Cloud Scheduler-Trigger hinzufügen

Führen Sie die folgenden Schritte aus, um Ihrer Integration einen Cloud Scheduler-Trigger hinzuzufügen:

Rufen Sie in der Google Cloud Console die Seite Anwendungsintegration auf.
Zur Seite „Application Integration“
Klicken Sie im Navigationsmenü auf Integrationen.
Die Seite Integrationsliste mit allen im Google Cloud-Projekt verfügbaren Integrationen wird angezeigt.
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.
Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
Klicken Sie auf das Cloud Scheduler-Triggerelement und platzieren Sie es im Integrationseditor.

Cloud Scheduler-Trigger konfigurieren

Führen Sie die folgenden Schritte aus, um einen Cloud Scheduler-Trigger zu konfigurieren:

Klicken Sie im Integrationseditor auf das Element Cloud Scheduler-Trigger, um den Bereich zur Triggerkonfiguration zu öffnen.
Geben Sie den Zeitplan des Cloud Scheduler-Triggers mit einer der folgenden Optionen an:
- Einfach: Verwenden Sie die Benutzeroberfläche, um den Cronjob-Zeitplan zu konfigurieren.
- Erweitert: Verwenden Sie einen unix-cron-Ausdruck, um den Cronjob-Zeitplan zu konfigurieren.
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 des Monats 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 monatlich oder während bestimmter Monate ausführen.
(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 mit einem 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.
Region : Wählen Sie die Region aus, in der Ihr Cloud Scheduler-Job bereitgestellt werden soll.
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 ist, erstellt Application Integration einen neuen Cloud Scheduler-Job in Ihrem Google Cloud-Projekt.

Ein Cloud Scheduler-Job wird nach 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 Logs zu Beginn und am Ende jeder Integrationsausführung. Sie können die Cloud Scheduler-Triggerlogs auf der Seite Log-Explorer von Cloud Logging ansehen:

Rufen Sie in der Google Cloud Console die Seite Cloud Scheduler auf.
Zu Cloud Scheduler
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.

Cloud Scheduler-Trigger bearbeiten

Application Integration

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

Rufen Sie in der Google Cloud Console die Seite Anwendungsintegration auf.
Zur Seite „Application Integration“
Klicken Sie im Navigationsmenü auf Integrations (Integrationen). Die Seite Integrations List (Integrationsliste) wird angezeigt.
Wählen Sie die Integrationen aus, die getestet werden sollen.
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.
Heben Sie die Veröffentlichung auf und aktivieren Sie die Bearbeitung, wenn die ausgewählte Integrationsversion veröffentlicht ist (im aktiven Status).
Klicken Sie im Integrationseditor auf das Element Cloud Scheduler-Trigger, um den Bereich zur Triggerkonfiguration zu öffnen.
Ändern Sie die Jobkonfigurationen von Cloud Scheduler nach Bedarf.

Cloud Scheduler

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

Rufen Sie in der Google Cloud Console Cloud Scheduler auf.
Zu Cloud Scheduler
Wählen Sie den zu bearbeitenden Cloud Scheduler -Job aus.
Klicken Sie auf Bearbeiten.
Ändern Sie die Jobkonfigurationen von Cloud Scheduler nach Bedarf.

Cloud Scheduler-Job pausieren, fortsetzen, kopieren

Application Integration unterstützt keine Anhalten-, Fortsetzungs- und Kopiervorgänge 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 Application Integration:

Rufen Sie in der Google Cloud Console die Seite Anwendungsintegration auf.
Zur Seite „Application Integration“
Klicken Sie im Navigationsmenü auf Integrations (Integrationen). Die Seite Integrations List (Integrationsliste) wird angezeigt.
Wählen Sie die Integrationen aus, die getestet werden sollen.
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.
Heben Sie die Veröffentlichung der ausgewählten Integrationsversion auf.
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:

Rufen Sie in der Google Cloud Console Cloud Scheduler auf.
Zu Cloud Scheduler
Wählen Sie den zu löschenden Cloud Scheduler -Job aus.
Klicken Sie auf Löschen.
Der Cloud Scheduler-Job für die entsprechende Integrationsversion wird gelöscht.

Best Practices

Heben Sie als Best Practice die Veröffentlichung aller Cloud Scheduler-Trigger auf, wenn sie nicht mehr benötigt werden. Wenn Sie einen redundanten Cloud Scheduler-Trigger veröffentlichen, ruft er die Integration weiterhin automatisch auf, wodurch zusätzliche Kosten entstehen können.

Fehlerbehebung bei Cloud Scheduler-Triggern

In der folgenden Tabelle werden die Fehler, die in Cloud Scheduler-Triggern auftreten können, und die entsprechenden Ursachen für die Fehler beschrieben.

Fehlerposition	Vorkommen des Fehlers	Fehlermeldung	Mögliche Ursachen	Lösung
Bereich für die Triggerkonfiguration > Fehlermeldung	Wenn der Cloud Scheduler-Job die Ausführung der Integration stoppt	`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 angehalten.	Fortsetzen des Cloud Scheduler-Jobs in 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.	Wenn Sie einen Job mit diesem Status wiederherstellen möchten, wiederholen Sie den Vorgang CloudScheduler.UpdateJob, bis Sie eine erfolgreiche Antwort erhalten.
		`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 hängt vom Cloud Scheduler-Produkt ab. Da diese Abhängigkeit außerhalb von Application Integration liegt, gelten die Nutzungsbedingungen des Service Level Agreement (SLA) für Application Integration nur, wenn die Ausführung für eine active-Integration erfolgreich geplant wurde.