Erstellen einer Amazon-EventBridge-Regel, die nach einem Zeitplan ausgeführt wird - Amazon EventBridge

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erstellen einer Amazon-EventBridge-Regel, die nach einem Zeitplan ausgeführt wird

Eine Regel kann als Antwort auf ein Ereignis oder in bestimmten Zeitintervallen ausgeführt werden. Um beispielsweise eine AWS Lambda-Funktion regelmäßig auszuführen, können Sie eine Regel erstellen, die nach einem Zeitplan ausgeführt wird.

Anmerkung

EventBridge bietet Amazon EventBridge Scheduler, wobei es sich um einen Serverless-Scheduler handelt, mit dem Sie Aufgaben von einem zentralen, verwalteten Service aus erstellen, ausführen und verwalten können. EventBridge Scheduler ist hochgradig anpassbar und bietet eine verbesserte Skalierbarkeit gegenüber den geplanten EventBridge-Regeln mit einer breiteren Palette von API-Zieloperationen und AWS-Services.

Wir empfehlen, dass Sie EventBridge Scheduler verwenden, um Ziele anhand eines Zeitplans aufzurufen. Weitere Informationen finden Sie unter Verwenden von Amazon EventBridge Scheduler mit Amazon EventBridge.

Sie können in EventBridge zwei Arten von geplanten Regeln erstellen:

  • Regeln, die regelmäßig ausgeführt werden

    EventBridge führt diese Regeln in regelmäßigen Abständen aus, z. B. alle 20 Minuten.

    Zum Festlegen des Zeitintervalls für eine geplante Regel definieren Sie einen Rate-Ausdruck.

  • Regeln, die zu bestimmten Zeiten ausgeführt werden

    EventBridge führt diese Regeln zu bestimmten Zeiten und Daten aus, z. B. um 8:00 Uhr. PST am ersten Montag jedes Monats

    Zur Angabe einer Uhrzeit und eines Datums, an dem eine geplante Regel ausgeführt wird, definieren Sie einen Cron-Ausdruck.

Rate-Ausdrücke sind einfacher zu definieren, während Cron-Ausdrücke eine detaillierte Steuerung des Zeitplans ermöglichen. Mit einem Cron-Ausdruck können Sie zum Beispiel eine Regel definieren, die zu bestimmten Uhrzeiten an bestimmten Tagen einer Woche oder eines Monats ausgeführt wird. Mit Rate-Ausdrücken dagegen wird die Regel in regelmäßigen Intervallen ausgeführt, zum Beispiel stündlich oder täglich.

Alle geplanten Ereignisse verwenden die Zeitzone UTC+0, und die Mindestanforderungen an die Genauigkeit der Zeitpläne beträgt eine Minute.

Anmerkung

EventBridge stellt in Zeitplanausdrücken keine Präzision der zweiten Ebene bereit. Die feinste Zeitauflösung bei Verwendung eines Cron-Ausdrucks ist eine Minute. Aufgrund der verteilten Natur von EventBridge und den Zielservices kann es zwischen dem Zeitpunkt der Auslösung der geplanten Regel und dem Zeitpunkt, zu dem der Zielservice die Zielressource ausführt, zu einer Verzögerung von einigen Sekunden kommen.

Das folgende Video gibt einen Überblick über die Planung von Aufgaben:

Erstellen einer Regel, die nach einem Zeitplan ausgeführt wird

In den folgenden Schritten erfahren Sie, wie Sie eine EventBridge-Regel erstellen, die nach einem regelmäßigen Zeitplan ausgeführt wird.

Anmerkung

Sie können geplante Regeln nur mit dem Standard-Event-Bus erstellen.

Definieren der Regel

Geben Sie zunächst einen Namen und eine Beschreibung für die Regel ein, um sie zu identifizieren.

So definieren Sie die Regeldetails
  1. Öffnen Sie die Amazon EventBridge-Konsole unter https://console.aws.amazon.com/events/.

  2. Wählen Sie im Navigationsbereich Rules aus.

  3. Wählen Sie Regel erstellen.

  4. Geben Sie für die Regel einen Namen und optional eine Beschreibung ein.

    Eine Regel darf nicht denselben Namen wie eine andere Regel in derselben AWS-Region und auf demselben Event Bus haben.

  5. Wählen Sie für Event Bus den Standard-Event-Bus aus. Sie können geplante Regeln nur mit dem Standard-Event-Bus erstellen.

  6. Damit die Regel sofort nach ihrer Erstellung wirksam wird, stellen Sie sicher, dass die Option Regel für den ausgewählten Event Bus aktivieren aktiviert ist.

  7. Wählen Sie unter Rule type (Regeltyp) die Option Schedule (Zeitplan) aus.

    An dieser Stelle können Sie wählen, ob Sie mit der Erstellung einer Regel fortfahren möchten, die nach einem Zeitplan ausgeführt wird, oder Amazon EventBridge Scheduler verwenden möchten.

  8. Wählen Sie aus, wie Sie fortfahren möchten:

    • Verwenden von EventBridge Scheduler, um Ihren Zeitplan zu erstellen

      Anmerkung

      EventBridge Scheduler ist ein Serverless-Scheduler, mit dem Sie Aufgaben von einem zentralen, verwalteten Service aus erstellen, ausführen und verwalten können. Er bietet Funktionen zur einmaligen und wiederkehrenden Terminplanung, unabhängig von Event Buses und Regeln. EventBridge Scheduler ist hochgradig anpassbar und bietet eine verbesserte Skalierbarkeit gegenüber den geplanten EventBridge-Regeln mit einer breiteren Palette von API-Zieloperationen und AWS-Services.

      Wir empfehlen, dass Sie EventBridge Scheduler verwenden, um Ziele anhand eines Zeitplans aufzurufen. Weitere Informationen finden Sie unter Was ist Amazon EventBridge Scheduler? im Benutzerhandbuch von Amazon EventBridge Scheduler.

      1. Wählen Sie In EventBridge Scheduler fortfahren aus.

        EventBridge öffnet die EventBridge-Scheduler-Konsole auf der Seite Zeitplan erstellen.

      2. Erstellen Sie den Zeitplan in der EventBridge-Scheduler-Konsole.

    • Verwenden Sie weiterhin EventBridge, um eine geplante Regel für den Standard-Event-Bus zu erstellen.

      1. Wählen Sie Mit dem Erstellen einer Regel fortfahren aus.

Definieren des Zeitplans

Als Nächstes definieren Sie das Zeitplanmuster.

So definieren Sie das Zeitplanmuster
  1. Wählen Sie für Zeitplanmuster aus, ob der Zeitplan zu einer bestimmten Zeit oder in regelmäßigen Intervallen ausgeführt werden soll:

    Specific time
    1. Wählen Sie Ein detaillierter Zeitplan, der zu einer bestimmten Zeit ausgeführt wird, z. B. um 8:00 Uhr aus. PST am ersten Montag jedes Monats

    2. Geben Sie für Cron-Ausdruck Felder an, um den Cron-Ausdruck zu definieren, den EventBridge verwenden sollte, um zu bestimmen, wann diese geplante Regel ausgeführt werden soll.

      Nachdem Sie alle Felder angegeben haben, zeigt EventBridge die nächsten zehn Daten an, an denen EventBridge diese geplante Regel ausführen wird. Sie können wählen, ob diese Daten in UTC oder in der lokalen Zeitzone angezeigt werden sollen.

      Weitere Informationen zum Erstellen eines Cron-Ausdrucks finden Sie unter Referenz für Cron-Ausdrücke.

    Regular rate
    1. Wählen Sie Ein Zeitplan, der regelmäßig ausgeführt wird, z. B. alle 10 Minuten aus.

    2. Geben Sie für Rate-Ausdruck die Felder Wert und Einheit an, um das Zeitintervall zu definieren, mit dem EventBridge diese geplante Regel ausführen soll.

      Weitere Informationen zum Erstellen eines Rate-Ausdrucks finden Sie unter Referenz für Rate-Ausdrücke.

  2. Wählen Sie Next (Weiter).

Auswählen von Zielen

Wählen Sie ein oder mehrere Ziele aus, um Ereignisse zu empfangen, die dem angegebenen Muster entsprechen. Zu den Zielen können ein EventBridge-Event-Bus, EventBridge-API-Ziele, einschließlich SaaS-Partner wie Salesforce, oder andere AWS-Service gehören.

So wählen Sie Ziele aus
  1. Wählen Sie für Zieltyp einen der folgenden Zieltypen aus:

    Event bus

    Zum Auswählen eines EventBridge-Event-Bus klicken Sie auf EventBridge-Event-Bus und gehen dann wie folgt vor:

    API destination

    Zum Verwenden eines EventBridge-API-Ziels wählen Sie EventBridge-API-Ziel aus und führen Sie dann einen der folgenden Schritte aus:

    • Zum Verwenden eines vorhandenen API-Ziels wählen Sie Vorhandenes API-Ziel verwenden aus. Wählen Sie dann ein API-Ziel aus der Dropdown-Liste aus.

    • Zum Erstellen eines neuen API-Ziels wählen Sie Neues API-Ziel erstellen aus. Geben Sie anschließend die folgenden Details für das Ziel an:

      • Name – Geben Sie einen Namen für das Ziel ein.

        Namen müssen innerhalb Ihres AWS-Konto-Kontos eindeutig sein. Namen können bis zu 64 Zeichen lang sein. Gültige Zeichen sind A-Z, a-z, 0-9 und . _ - (Bindestrich).

      • (Optional) Beschreibung – Geben Sie eine Beschreibung für das Ziel ein.

        Beschreibungen können bis zu 512 Zeichen lang sein.

      • API-Zielendpunkt – Der URL-Endpunkt für das Ziel.

        Die Endpunkt-URL muss mit https beginnen. Sie können das * als Pfadparameterplatzhalter angeben. Sie können Pfadparameter über das HttpParameters-Attribut des Ziels festlegen.

      • HTTP-Methode – Wählen Sie die HTTP-Methode aus, die beim Aufrufen des Endpunkts verwendet wird.

      • (Optional) Aufrufratenlimit pro Sekunde – Geben Sie die maximale Anzahl von Aufrufen ein, die pro Sekunde für dieses Ziel akzeptiert werden.

        Dieser Wert muss größer als null sein. Standardmäßig ist dieser Wert auf 300 festgelegt.

      • Verbindung – Wählen Sie, ob Sie eine neue oder eine vorhandene Verbindung verwenden möchten:

        • Zum Verwenden einer vorhandenen Verbindung wählen Sie Vorhandene Verbindung verwenden und die Verbindung aus der Dropdown-Liste aus.

        • Zum Erstellen einer neuen Verbindung für dieses Ziel wählen Sie Neue Verbindung erstellen aus und definieren dann den Namen, den Zieltyp und den Autorisierungstyp der Verbindung. Sie können auch eine optionale Beschreibung für diese Verbindung hinzufügen.

    Weitere Informationen finden Sie unter API-Ziele.

    AWS-Service

    Zum Verwenden eines AWS-Service wählen Sie AWS-Service aus und gehen dann wie folgt vor:

    1. Wählen Sie für Ziel auswählen einen AWS-Service aus, der als Ziel verwendet werden soll. Geben Sie die angeforderten Informationen für den ausgewählten Service ein.

      Anmerkung

      Die angezeigten Felder variieren je nach ausgewähltem Service. Weitere Informationen zu verfügbaren Zielen finden Sie unter In der EventBridge Konsole verfügbare Ziele.

  2. Für viele Zieltypen benötigt EventBridge Berechtigungen zum Senden von Ereignissen an das Ziel. In diesen Fällen kann EventBridge die IAM-Rolle erstellen, die zum Ausführen Ihrer Regel erforderlich ist.

    Führen Sie für Ausführungsrolle einen der folgenden Schritte aus:

    • Gehen Sie wie folgt vor, um eine neue Ausführungsrolle für diese Regel zu erstellen:

      1. Wählen Sie Eine neue Rolle für diese spezifische Ressource erstellen aus.

      2. Geben Sie entweder einen Namen für diese Ausführungsrolle ein, oder verwenden Sie den von EventBridge generierten Namen.

    • So verwenden Sie eine vorhandene Ausführungsrolle für diese Regel:

      1. Wählen Sie Vorhandene Rolle verwenden aus.

      2. Geben Sie den Namen der zu verwendenden Ausführungsrolle ein oder wählen Sie ihn aus der Dropdown-Liste aus.

  3. (Optional) Geben Sie für Zusätzliche Einstellungen eine der optionalen Einstellungen an, die für Ihren Zieltyp verfügbar sind:

    Event bus

    (Optional) Wählen Sie für Warteschlange für unzustellbare Nachrichten aus, ob Sie eine standardmäßige Amazon-SQS-Warteschlange als Warteschlange für unzustellbare Nachrichten verwenden möchten. EventBridge sendet Ereignisse, die dieser Regel entsprechen, an die Warteschlange für Dead-Letter, wenn sie nicht erfolgreich an das Ziel übermittelt wurden. Führen Sie eine der folgenden Aktionen aus:

    • Klicken Sie auf Keine, um keine Warteschlange für unzustellbare Nachrichten zu verwenden.

    • Klicken Sie auf Wählen Sie eine Amazon SQS Warteschlange im aktuellen AWS-Konto als Warteschlange für unzustellbare Nachrichten und wählen Sie dann die Warteschlange aus der Dropdown-Liste aus.

    • Klicken Sie auf Wählen Sie eine Amazon SQS Warteschlange in einem anderen AWS-Konto als Warteschlange für unzustellbare Nachrichten und geben Sie dann den ARN der Warteschlange ein, die verwendet werden soll. Sie müssen eine ressourcenbasierte Richtlinie an die Warteschlange anhängen, die EventBridge Berechtigung zum Senden von Nachrichten an die Warteschlange erteilt.

      Weitere Informationen finden Sie unter Erteilen von Berechtigungen für die Warteschlange für unzustellbare Nachrichten.

    API destination
    1. (Optional) Wählen Sie für „Zieleingabe konfigurieren“ aus, wie Sie den an das Ziel gesendeten Text für passende Ereignisse anpassen möchten. Wählen Sie eine der folgenden Optionen aus:

      • Übereinstimmende Ereignisse – EventBridge sendet das gesamte ursprüngliche Quellereignis an das Ziel. Dies ist die Standardeinstellung.

      • Teil der übereinstimmenden Ereignisse – EventBridge sendet nur den angegebenen Teil des ursprünglichen Quellereignisses an das Ziel.

        Geben Sie unter Den Teil des übereinstimmenden Ereignisses angeben einen JSON-Pfad an, der den Teil des Ereignisses definiert, den EventBridge an das Ziel senden soll.

      • Konstante (JSON-Text) – EventBridge sendet nur den angegebenen JSON-Text an das Ziel. Es wird kein Teil des ursprünglichen Quellereignisses gesendet.

        Geben Sie unter Die Konstante in JSON angeben den JSON-Text an, den EventBridge anstelle des Ereignisses an das Ziel senden soll.

      • Eingabe-Transformator – Konfigurieren Sie einen Eingabe-Transformator, um den Text anzupassen, den EventBridge an das Ziel senden soll. Weitere Informationen finden Sie unter Amazon- EventBridge Eingabetransformation.

        1. Wählen Sie Eingabe-Transformator konfigurieren aus.

        2. Konfigurieren Sie den Eingabe-Transformator wie unter Konfigurieren eines Eingabe-Transformators als Teil der Erstellung einer Regel beschrieben.

    2. (Optional) Geben Sie unter Wiederholungsrichtlinie an, wie EventBridge das Senden eines Ereignisses an ein Ziel wiederholen soll, nachdem ein Fehler aufgetreten ist.

      • Maximales Alter des Ereignisses – Geben Sie die maximale Zeitspanne (in Stunden, Minuten und Sekunden) ein, für die EventBridge unverarbeitete Ereignisse beibehält. Die Standardeinstellung ist 24 Stunden.

      • Wiederholungsversuche – Geben Sie ein, wie oft EventBridge das Senden an ein Ziel maximal wiederholen soll, nachdem ein Fehler aufgetreten ist. Die Standardeinstellung ist 185 Mal.

    3. (Optional) Wählen Sie für Warteschlange für unzustellbare Nachrichten aus, ob Sie eine standardmäßige Amazon-SQS-Warteschlange als Warteschlange für unzustellbare Nachrichten verwenden möchten. EventBridge sendet Ereignisse, die dieser Regel entsprechen, an die Warteschlange für Dead-Letter, wenn sie nicht erfolgreich an das Ziel übermittelt wurden. Führen Sie eine der folgenden Aktionen aus:

      • Klicken Sie auf Keine, um keine Warteschlange für unzustellbare Nachrichten zu verwenden.

      • Klicken Sie auf Wählen Sie eine Amazon SQS Warteschlange im aktuellen AWS-Konto als Warteschlange für unzustellbare Nachrichten und wählen Sie dann die Warteschlange aus der Dropdown-Liste aus.

      • Klicken Sie auf Wählen Sie eine Amazon SQS Warteschlange in einem anderen AWS-Konto als Warteschlange für unzustellbare Nachrichten und geben Sie dann den ARN der Warteschlange ein, die verwendet werden soll. Sie müssen eine ressourcenbasierte Richtlinie an die Warteschlange anhängen, die EventBridge Berechtigung zum Senden von Nachrichten an die Warteschlange erteilt.

        Weitere Informationen finden Sie unter Erteilen von Berechtigungen für die Warteschlange für unzustellbare Nachrichten.

    AWS service

    Beachten Sie, dass EventBridge möglicherweise nicht alle der folgenden Felder für einen bestimmten AWS-Service anzeigt.

    1. (Optional) Wählen Sie für „Zieleingabe konfigurieren“ aus, wie Sie den an das Ziel gesendeten Text für passende Ereignisse anpassen möchten. Wählen Sie eine der folgenden Optionen aus:

      • Übereinstimmende Ereignisse – EventBridge sendet das gesamte ursprüngliche Quellereignis an das Ziel. Dies ist die Standardeinstellung.

      • Teil der übereinstimmenden Ereignisse – EventBridge sendet nur den angegebenen Teil des ursprünglichen Quellereignisses an das Ziel.

        Geben Sie unter Den Teil des übereinstimmenden Ereignisses angeben einen JSON-Pfad an, der den Teil des Ereignisses definiert, den EventBridge an das Ziel senden soll.

      • Konstante (JSON-Text) – EventBridge sendet nur den angegebenen JSON-Text an das Ziel. Es wird kein Teil des ursprünglichen Quellereignisses gesendet.

        Geben Sie unter Die Konstante in JSON angeben den JSON-Text an, den EventBridge anstelle des Ereignisses an das Ziel senden soll.

      • Eingabe-Transformator – Konfigurieren Sie einen Eingabe-Transformator, um den Text anzupassen, den EventBridge an das Ziel senden soll. Weitere Informationen finden Sie unter Amazon- EventBridge Eingabetransformation.

        1. Wählen Sie Eingabe-Transformator konfigurieren aus.

        2. Konfigurieren Sie den Eingabe-Transformator wie unter Konfigurieren eines Eingabe-Transformators als Teil der Erstellung einer Regel beschrieben.

    2. (Optional) Geben Sie unter Wiederholungsrichtlinie an, wie EventBridge das Senden eines Ereignisses an ein Ziel wiederholen soll, nachdem ein Fehler aufgetreten ist.

      • Maximales Alter des Ereignisses – Geben Sie die maximale Zeitspanne (in Stunden, Minuten und Sekunden) ein, für die EventBridge unverarbeitete Ereignisse beibehält. Die Standardeinstellung ist 24 Stunden.

      • Wiederholungsversuche – Geben Sie ein, wie oft EventBridge das Senden an ein Ziel maximal wiederholen soll, nachdem ein Fehler aufgetreten ist. Die Standardeinstellung ist 185 Mal.

    3. (Optional) Wählen Sie für Warteschlange für unzustellbare Nachrichten aus, ob Sie eine standardmäßige Amazon-SQS-Warteschlange als Warteschlange für unzustellbare Nachrichten verwenden möchten. EventBridge sendet Ereignisse, die dieser Regel entsprechen, an die Warteschlange für Dead-Letter, wenn sie nicht erfolgreich an das Ziel übermittelt wurden. Führen Sie eine der folgenden Aktionen aus:

      • Klicken Sie auf Keine, um keine Warteschlange für unzustellbare Nachrichten zu verwenden.

      • Klicken Sie auf Wählen Sie eine Amazon SQS Warteschlange im aktuellen AWS-Konto als Warteschlange für unzustellbare Nachrichten und wählen Sie dann die Warteschlange aus der Dropdown-Liste aus.

      • Klicken Sie auf Wählen Sie eine Amazon SQS Warteschlange in einem anderen AWS-Konto als Warteschlange für unzustellbare Nachrichten und geben Sie dann den ARN der Warteschlange ein, die verwendet werden soll. Sie müssen eine ressourcenbasierte Richtlinie an die Warteschlange anhängen, die EventBridge Berechtigung zum Senden von Nachrichten an die Warteschlange erteilt.

        Weitere Informationen finden Sie unter Erteilen von Berechtigungen für die Warteschlange für unzustellbare Nachrichten.

  4. (Optional) Wählen Sie Add another target (Weiteres Ziel hinzufügen) aus, um ein weiteres Ziel für diese Regel hinzuzufügen.

  5. Wählen Sie Next (Weiter).

Konfigurieren von Tags und Überprüfen von Regeln

Geben Sie abschließend alle gewünschten Tags für die Regel ein, überprüfen und erstellen Sie dann die Regel.

So konfigurieren Sie Tags und überprüfen und erstellen die Regel
  1. (Optional) Geben Sie ein oder mehrere Tags für die Regel ein. Weitere Informationen finden Sie unter Amazon-EventBridge-Tags.

  2. Wählen Sie Next (Weiter).

  3. Überprüfen Sie die Details der neuen Regel. Um Änderungen an einem Abschnitt vorzunehmen, wählen Sie neben diesem Abschnitt die Schaltfläche Bearbeiten aus.

    Wenn Sie mit den Regeldetails zufrieden sind, wählen Sie Regel erstellen aus.