Verwenden von Lambda mit Amazon EventBridge Scheduler

Amazon EventBridge Scheduler ist ein Serverless-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 mit 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 unverarbeitete Ereignisse festlegen.

Wenn Sie EventBridge Scheduler mit Lambda einrichten, ruft EventBridge Scheduler Ihre Lambda-Funktion asynchron auf. Auf dieser Seite wird erläutert, wie Sie mit dem EventBridge Scheduler eine Lambda-Funktion nach einem Zeitplan aufrufen.

Einrichten der Ausführungsrolle

Wenn Sie einen neuen Zeitplan erstellen, muss EventBridge Scheduler über die Berechtigung verfügen, seine Ziel-API-Operation in Ihrem Namen aufzurufen. Sie erteilen 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 der Ziel-API ab, die EventBridge Scheduler aufrufen soll.

Wenn Sie die EventBridge Scheduler-Konsole verwenden, um einen Zeitplan zu erstellen, wie im folgenden Verfahren, richtet EventBridge Scheduler automatisch eine Ausführungsrolle basierend auf Ihrem ausgewählten Ziel ein. Wenn Sie einen Zeitplan mit einem der EventBridge Scheduler-SDKs , oder erstellen möchten AWS CLI AWS CloudFormation, müssen Sie über eine vorhandene Ausführungsrolle verfügen, 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 unter https://console.aws.amazon.com/scheduler/home.

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 aus.

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

   1. Wählen Sie AWS Lambda  aufrufen aus.

   2. Wählen Sie im Abschnitt Aufrufen eine Funktion aus oder wählen Sie Neue Lambda-Funktion erstellen.

   3. (Optional) Geben Sie eine JSON-Nutzlast ein. Wenn Sie keine Nutzlast eingeben, verwendet EventBridge Scheduler ein leeres Ereignis, um die Funktion aufzurufen.

8. Wählen Sie Weiter aus.

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 unzustellbare Nachrichten (DLQ) wie folgt vor:

      • Aktivieren Sie die Option Wiederholen.

      • Geben Sie für Höchstalter des Ereignisses die maximale Stunde(n) und min(s) ein, die EventBridge Scheduler ein unverarbeitetes Ereignis beibehalten muss.

      • Die Höchstdauer beträgt 24 Stunden.

      • Geben Sie für Maximale Anzahl Wiederholungen die maximale Anzahl von Wiederholungen des Zeitplans durch den EventBridge Scheduler ein, wenn das Ziel einen Fehler zurückgibt.

        Der Maximalwert beträgt 185 Wiederholungen.

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

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

      Option für Warteschlange für unzustellbare Nachrichten (DLQ)	Vorgehensweise
      Nicht speichern	Wählen Sie None.
      Speichern Sie das Ereignis in derselben AWS-Konto , in der Sie den Zeitplan erstellen	Wählen Sie Eine Amazon SQS-Warteschlange in meinem AWS-Konto als DLQ auswählen aus. Wählen Sie den Amazon-Ressourcennamen (ARN) der Amazon SQS-Warteschlange.
      Speichern Sie das Ereignis in einer anderen AWS-Konto als der, in der Sie den Zeitplan erstellen	Wählen Sie Eine Amazon SQS-Warteschlange in anderen AWS-Konten als DLQ angeben aus. Geben Sie den Amazon-Ressourcennamen (ARN) der Amazon-SQS-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 CMK-ARN ein oder wählen Sie Erstellen eines  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 aus. Geben Sie dann einen Namen für Rollenname ein. Wenn Sie diese Option wählen, fügt EventBridge Scheduler der Rolle die erforderlichen Berechtigungen für Ihr Vorlagenziel hinzu.

10. Wählen Sie Weiter aus.

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 bestätigen, dass EventBridge Scheduler die Funktion aufgerufen hat, überprüfen Sie die Amazon- CloudWatch Protokolle der Funktion .

Zugehörige Ressourcen

Weitere Informationen zu EventBridge Scheduler finden Sie hier:

• EventBridge Scheduler-Benutzerhandbuch

• EventBridge Scheduler-API-Referenz

• EventBridge Scheduler-Preise