Amazon EventBridge Scheduler verwenden, um die Ausführung einer Step Functions Functions-Zustandsmaschine zu starten

Amazon EventBridge Scheduler ist ein serverloser Scheduler, mit dem Sie Aufgaben von einem zentralen, verwalteten Service aus erstellen, ausführen und verwalten können. Mit EventBridge Scheduler können Sie Zeitpläne mithilfe von Cron- und Rate-Ausdrücken für wiederkehrende Muster erstellen oder einmalige Aufrufe konfigurieren. Sie können flexible Zeitfenster für die Zustellung einrichten, Wiederholungslimits definieren und die maximale Aufbewahrungszeit für fehlgeschlagene Aufrufe festlegen. API

Mit EventBridge Scheduler können Sie beispielsweise eine State-Machine-Ausführung nach einem Zeitplan starten, wenn ein sicherheitsrelevantes Ereignis eintritt, oder um einen Datenverarbeitungsjob zu automatisieren.

Auf dieser Seite wird erklärt, wie Sie den EventBridge Scheduler verwenden, um die Ausführung einer Step Functions Functions-Zustandsmaschine nach einem Zeitplan zu starten.

Einrichten der Ausführungsrolle

Wenn Sie einen neuen Zeitplan erstellen, muss der EventBridge Scheduler berechtigt sein, den API Zielvorgang in Ihrem Namen aufzurufen. Sie gewähren EventBridge Scheduler diese Berechtigungen mithilfe einer Ausführungsrolle. Die Berechtigungsrichtlinie, die Sie der Ausführungsrolle Ihres Zeitplans hinzufügen, definiert die erforderlichen Berechtigungen. Diese Berechtigungen hängen von dem Ziel ab, API das EventBridge Scheduler aufrufen soll.

Wenn Sie die EventBridge Scheduler-Konsole verwenden, um einen Zeitplan zu erstellen, wie im folgenden Verfahren beschrieben, richtet EventBridge Scheduler automatisch eine Ausführungsrolle auf der Grundlage Ihres ausgewählten Ziels ein. Wenn Sie einen Zeitplan mit einem der EventBridge SchedulerSDKs, dem AWS CLI, oder erstellen möchten, müssen Sie über eine bestehende Ausführungsrolle verfügen AWS CloudFormation, die die Berechtigungen gewährt, die EventBridge Scheduler zum Aufrufen eines Ziels benötigt. Weitere Informationen zum manuellen Einrichten einer Ausführungsrolle für Ihren Zeitplan finden Sie unter Einrichten einer Ausführungsrolle im EventBridge Scheduler-Benutzerhandbuch.

Erstellen eines Zeitplans

So erstellen Sie einen Zeitplan mithilfe der Konsole

1. Öffnen Sie die Amazon EventBridge Scheduler-Konsole zu https://console.aws.amazon.com/scheduler/Hause.

2. Wählen Sie auf der Seite Zeitpläne die Option Zeitplan erstellen aus.

3. Gehen Sie auf der Seite Zeitplandetails angeben im Abschnitt Zeitplanname und -beschreibung wie folgt vor:

   1. Geben Sie unter Zeitplanname einen Namen für Ihren Zeitplan ein. Beispiel, MyTestSchedule.

   2. (Optional) Geben Sie unter Beschreibung eine Beschreibung für Ihren Zeitplan ein. Beispiel, My first schedule.

   3. Wählen Sie für Zeitplangruppe eine Zeitplangruppe aus der Dropdown-Liste aus. Wenn Sie noch keine Gruppe haben, wählen Sie Standard. Um eine Zeitplangruppe zu erstellen, wählen Sie Eigenen Zeitplan erstellen.

      Sie verwenden Zeitplangruppen, um Tags zu Zeitplangruppen hinzuzufügen.

4. 1. Wählen Sie Ihre Zeitplanoptionen.

      Vorkommen	Vorgehensweise
      Einmaliger Zeitplan Ein einmaliger Zeitplan ruft ein Ziel nur einmal zu dem von Ihnen angegebenen Datum und der angegebenen Uhrzeit auf.	Gehen Sie für Datum und Uhrzeit wie folgt vor: Geben Sie ein gültiges Datum im YYYY/MM/DD-Format ein. Geben Sie einen Zeitstempel im 24-Stunden-Format (hh:mm) ein. Wählen Sie unter Zeitzone die Zeitzone aus.
      Wiederkehrender Zeitplan Ein wiederkehrender Zeitplan ruft ein Ziel mit einer Rate auf, die Sie mit einem cron-Ausdruck oder einem Rate-Ausdruck angeben.	Gehen Sie bei Zeitplantyp wie folgt vor: Um den Zeitplan mithilfe eines Cron-Ausdrucks zu definieren, wählen Sie Cron-basierter Zeitplan und geben Sie den Cron-Ausdruck ein. Um den Zeitplan mithilfe eines Rate-Ausdrucks zu definieren, wählen Sie Rate-Ausdruck ein. Weitere Informationen zu Cron- und Rate-Ausdrücken finden Sie unter Zeitplantypen auf EventBridge Scheduler im Amazon EventBridge Scheduler-Benutzerhandbuch. Wählen Sie für Flexibles Zeitfenster die Option Aus, um die Option zu deaktivieren, oder wählen Sie eines der vordefinierten Zeitfenster aus. Wenn Sie beispielsweise 15 Minuten auswählen und einen wiederkehrenden Zeitplan festlegen, der sein Ziel einmal pro Stunde aufruft, wird der Zeitplan innerhalb von 15 Minuten nach Beginn jeder Stunde ausgeführt.

5. (Optional) Wenn Sie im vorherigen Schritt Wiederkehrender Zeitplan ausgewählt haben, gehen Sie im Abschnitt Zeitrahmen wie folgt vor:

   1. Wählen Sie unter Zeitzone eine Zeitzone aus.

   2. Geben Sie für Startdatum und -uhrzeit ein gültiges Datum im YYYY/MM/DD-Format ein und geben Sie dann einen Zeitstempel im 24-Stunden-Format (hh:mm) an.

   3. Geben Sie für Enddatum und -uhrzeit ein gültiges Datum im YYYY/MM/DD-Format ein und geben Sie dann einen Zeitstempel im 24-Stunden-Format (hh:mm) an.

6. Wählen Sie Weiter.

7. Wählen Sie auf der Seite „Ziel auswählen“ den AWS API Vorgang aus, den der Scheduler aufruft EventBridge :

   1. Wählen Sie. AWS Step Functions StartExecution

   2. Wählen Sie in dem StartExecutionAbschnitt einen Zustandsmaschine aus oder wählen Sie Neuen Zustandsmaschine erstellen.

      Derzeit können Sie Synchronous Express-Workflows nicht nach einem Zeitplan ausführen.

   3. Geben Sie eine JSON Nutzlast für die Ausführung ein. Auch wenn Ihre Zustandsmaschine keine JSON Nutzdaten benötigt, müssen Sie dennoch Eingaben in einem JSON Format angeben, wie im folgenden Beispiel gezeigt.

      {
          "Comment": "sampleJSONData"
      }

8. Wählen Sie Weiter.

9. Führen Sie auf der Seite Settings (Einstellungen) die folgenden Schritte aus:

   1. Um den Zeitplan zu aktivieren, schalten Sie unter Zeitplanstatus die Option Zeitplan aktivieren ein.

   2. Um eine Wiederholungsrichtlinie für Ihren Zeitplan zu konfigurieren, gehen Sie unter Wiederholungsrichtlinie und Warteschlange für unzulässige Briefe (DLQ) wie folgt vor:

      • Aktivieren Sie die Option Wiederholen.

      • Geben Sie unter Höchstalter des Ereignisses die maximale (n) Stunde (n) und Minute (n) ein, für die der EventBridge Scheduler ein unbearbeitetes Ereignis speichern darf.

      • Die Höchstdauer beträgt 24 Stunden.

      • Geben Sie unter Maximale Anzahl an Wiederholungen ein, wie oft der EventBridge Scheduler den Zeitplan maximal wiederholt, wenn das Ziel einen Fehler zurückgibt.

        Der Maximalwert beträgt 185 Wiederholungen.

      Bei Wiederholungsrichtlinien führt der Scheduler den Zeitplan erneut aus, wenn ein Zeitplan sein Ziel nicht aufrufen kann. EventBridge Falls konfiguriert, müssen Sie die maximale Aufbewahrungszeit und Wiederholungsversuche für den Zeitplan festlegen.

   3. Wählen Sie aus, wo der EventBridge Scheduler nicht zugestellte Ereignisse speichert.

      Option „Warteschlange für unzustellbare Briefe“ () DLQ	Vorgehensweise
      Nicht speichern	Wählen Sie None.
      Speichern Sie das Ereignis AWS-Konto dort, wo Sie den Zeitplan erstellen	Wählen Sie „Wählen Sie eine SQS Amazon-Warteschlange aus“ in „Mein AWS-Konto als DLQ“. Wählen Sie den Amazon-Ressourcennamen (ARN) der SQS Amazon-Warteschlange.
      Speichern Sie das Ereignis an einem anderen Ort als AWS-Konto dem, an dem Sie den Zeitplan erstellen	Wählen Sie Spezifizieren Sie eine SQS Amazon-Warteschlange AWS-Konten unter Andere als DLQ. Geben Sie den Amazon-Ressourcennamen (ARN) der SQS Amazon-Warteschlange ein.

   4. Um einen kundenverwalteten Schlüssel zur Verschlüsselung Ihrer Zieleingabe zu verwenden, wählen Sie unter Verschlüsselung die Option Verschlüsselungseinstellungen anpassen (erweitert).

      Wenn Sie diese Option wählen, geben Sie einen vorhandenen KMS Schlüssel ein ARN oder wählen Sie Create an AWS KMS key, um zur AWS KMS Konsole zu navigieren. Weitere Informationen darüber, wie EventBridge Scheduler Ihre Daten im Ruhezustand verschlüsselt, finden Sie unter Verschlüsselung im Ruhezustand im Amazon EventBridge Scheduler-Benutzerhandbuch.

   5. Damit EventBridge Scheduler eine neue Ausführungsrolle für Sie erstellt, wählen Sie Neue Rolle für diesen Zeitplan erstellen. Geben Sie dann einen Namen für Rollenname ein. Wenn Sie diese Option wählen, ordnet EventBridge Scheduler der Rolle die erforderlichen Berechtigungen zu, die für Ihr vorgegebenes Ziel erforderlich sind.

10. Wählen Sie Weiter.

11. Überprüfen Sie auf der Seite Zeitplan überprüfen und erstellen die Details Ihres Zeitplans. Wählen Sie in jedem Abschnitt Bearbeiten aus, um zu diesem Schritt zurückzukehren und seine Details zu bearbeiten.

12. Wählen Sie Zeitplan erstellen.

    Auf der Seite Zeitpläne können Sie eine Liste Ihrer neuen und vorhandenen Zeitpläne anzeigen. Überprüfen Sie in der Spalte Status, ob Ihr neuer Zeitplan aktiviert ist.

Um zu überprüfen, ob der EventBridge Scheduler die Zustandsmaschine aufgerufen hat, überprüfen Sie die CloudWatch Amazon-Protokolle der Zustandsmaschine.

Zugehörige Ressourcen

Weitere Informationen zu EventBridge Scheduler finden Sie im Folgenden:

• EventBridge Scheduler-Benutzerhandbuch

• EventBridge Scheduler-Referenz API

• EventBridge Preise für Scheduler