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

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.

Eine Regel erstellen, die nach einem Zeitplan in Amazon ausgeführt wird EventBridge

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

Sie können zwar Regeln erstellen, die nach einem Zeitplan ausgeführt werden, bietet EventBridge aber jetzt eine flexiblere und leistungsfähigere Möglichkeit, geplante Aufgaben zentral zu erstellen, auszuführen und zu verwalten: EventBridge Scheduler. 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

Scheduler ist in hohem Maße anpassbar und bietet eine verbesserte Skalierbarkeit im Vergleich zu geplanten Regeln sowie ein breiteres Spektrum an API Zieloperationen und -diensten. AWS Wir empfehlen, dass Sie Scheduler verwenden, um Ziele nach einem Zeitplan aufzurufen.

Weitere Informationen finden Sie unter Erstellen eines Zeitplans.

In EventBridge können Sie 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. PSTjeden ersten Montag im Monat.

    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 Mindestgenauigkeit für einen Zeitplan beträgt eine Minute.

Anmerkung

EventBridge bietet keine Genauigkeit der zweiten Ebene in Zeitplanausdrücken. Die feinste Zeitauflösung bei Verwendung eines Cron-Ausdrucks ist eine Minute. Aufgrund des verteilten Charakters der Dienste EventBridge und der Zieldienste kann es zwischen dem Zeitpunkt, zu dem die geplante Regel ausgelöst wird, und dem Zeitpunkt, zu dem der Zieldienst die Zielressource ausführt, zu einer Verzögerung von mehreren 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 EventBridge Amazon-Konsole unter https://console.aws.amazon.com/events/.

  2. Wählen Sie im Navigationsbereich Rules aus.

  3. Wählen Sie Regel erstellen aus.

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

    Eine Regel kann nicht denselben Namen haben wie eine andere Regel im selben AWS-Region und im selben Event-Bus.

  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 Sie EventBridge Scheduler, um Ihren Zeitplan zu erstellen

      Anmerkung

      EventBridge Scheduler ist ein serverloser Scheduler, mit dem Sie Aufgaben von einem zentralen, verwalteten Dienst aus erstellen, ausführen und verwalten können. Er bietet Funktionen zur einmaligen und wiederkehrenden Terminplanung, unabhängig von Event Buses und Regeln. EventBridge Der Scheduler ist in hohem Maße anpassbar und bietet eine verbesserte Skalierbarkeit im Vergleich zu EventBridge geplanten Regeln sowie ein breiteres Spektrum an API Zieloperationen und -diensten. AWS

      Wir empfehlen, dass Sie EventBridge Scheduler verwenden, um Ziele nach einem Zeitplan aufzurufen. Weitere Informationen finden Sie unter Was ist Amazon EventBridge Scheduler? im Amazon EventBridge Scheduler-Benutzerhandbuch.

      1. Wählen Sie im Scheduler EventBridge Weiter

        EventBridge öffnet in der EventBridge Scheduler-Konsole die Seite „Zeitplan erstellen“.

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

    • Verwenden Sie EventBridge diese Option weiter, 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. PSTjeden ersten Montag im Monat.

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

      Sobald Sie alle Felder angegeben haben, EventBridge werden die nächsten zehn Termine angezeigt, an denen diese geplante EventBridge Regel ausgeführt wird. Sie können wählen, ob diese Daten in UTCoder in der lokalen Zeitzone angezeigt werden sollen.

      Weitere Informationen zum Erstellen eines Cron-Ausdrucks finden Sie unter 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 den Ausdruck Rate die Felder Wert und Einheit an, um die Rate zu definieren, mit der diese geplante Regel ausgeführt werden EventBridge soll.

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

  2. Wählen Sie Weiter aus.

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 Eventbus, EventBridge API Ziele, einschließlich SaaS-Partner wie Salesforce, oder andere gehören AWS-Service.

So wählen Sie Ziele aus

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

    Event bus

    Um einen EventBridge Event-Bus auszuwählen, wählen Sie EventBridge Event-Bus aus und gehen dann wie folgt vor:

    API destination

    Um ein EventBridge API Ziel zu verwenden, wählen Sie EventBridge APIZiel aus und führen Sie dann einen der folgenden Schritte aus:

    • Um ein vorhandenes API Ziel zu verwenden, wählen Sie Bestehendes API Ziel verwenden aus. Wählen Sie dann ein API Ziel aus der Drop-down-Liste aus.

    • Um ein neues API Ziel zu erstellen, 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.

      • APIZielendpunkt — Der URL Endpunkt für das Ziel.

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

      • HTTPMethode — Wählen Sie die HTTP Methode aus, die beim Aufrufen des Endpunkts verwendet wurde.

      • (Optional) Begrenzung der Aufrufrate 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 APIZiele als Ziele bei Amazon EventBridge.

    AWS-Service

    Um eine zu verwenden AWS-ServiceAWS-Service, wählen Sie aus und gehen Sie 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 Event-Bus-Ziele sind in der EventBridge Konsole verfügbar.

  2. Für viele Zieltypen sind EventBridge Berechtigungen erforderlich, um Ereignisse an das Ziel zu senden. In diesen Fällen EventBridge kann die IAM Rolle erstellt werden, die für die Ausführung 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 Namen, der von generiert wurde EventBridge.

    • 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 die Warteschlange für unzustellbare Briefe aus, ob Sie eine standardmäßige SQS Amazon-Warteschlange als Warteschlange für unzustellbare Briefe verwenden möchten. EventBridge sendet Ereignisse, die dieser Regel entsprechen, an die Warteschlange für unzustellbare Briefe, wenn sie nicht erfolgreich an das Ziel zugestellt wurden. Führen Sie eine der folgenden Aktionen aus:

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

    • Wählen Sie Wählen Sie eine SQS Amazon-Warteschlange im aktuellen AWS Konto aus, die als Warteschlange für eingehende Briefe verwendet werden soll, und wählen Sie dann die zu verwendende Warteschlange aus der Drop-down-Liste aus.

    • Wählen Sie Wählen Sie eine SQS Amazon-Warteschlange in einem anderen AWS Konto als Warteschlange für eingehende Briefe aus und geben Sie dann die ARN Warteschlange ein, die Sie verwenden möchten. Sie müssen der Warteschlange eine ressourcenbasierte Richtlinie hinzufügen, die das Senden von Nachrichten an die Warteschlange EventBridge gestattet.

      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 — sendet EventBridge nur den angegebenen Teil des ursprünglichen Quellereignisses an das Ziel.

        Geben Sie unter Geben Sie den Teil des übereinstimmenden Ereignisses an einen JSON Pfad an, der den Teil des Ereignisses definiert EventBridge , den Sie an das Ziel senden möchten.

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

        Geben Sie unter Konstante angeben in JSON den JSON Text an, den Sie an das Ziel statt an das Ereignis senden möchten EventBridge .

      • Eingangstransformator — Konfigurieren Sie einen Eingangstransformator, um den Text, den Sie an das Ziel EventBridge senden möchten, anzupassen. Weitere Informationen finden Sie unter Transformation Amazon EventBridge Amazon-Eingaben.

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

        2. Konfigurieren Sie den Eingabe-Transformator wie unter Konfiguration eines Eingangstransformators beim Erstellen einer Regel in EventBridge beschrieben.

    2. (Optional) Geben Sie unter Wiederholungsrichtlinie an, wie erneut versucht EventBridge werden soll, ein Ereignis an ein Ziel zu senden, nachdem ein Fehler aufgetreten ist.

      • Maximales Alter des Ereignisses — Geben Sie die maximale Dauer (in Stunden, Minuten und Sekunden) ein, für die unverarbeitete Ereignisse aufbewahrt werden EventBridge sollen. Die Standardeinstellung ist 24 Stunden.

      • Wiederholungsversuche — Geben Sie ein, wie oft nach dem Auftreten eines Fehlers maximal versucht werden EventBridge soll, ein Ereignis an das Ziel zu senden. Die Standardeinstellung ist 185 Mal.

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

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

      • Wählen Sie Wählen Sie eine SQS Amazon-Warteschlange im aktuellen AWS Konto aus, die als Warteschlange für eingehende Briefe verwendet werden soll, und wählen Sie dann die zu verwendende Warteschlange aus der Drop-down-Liste aus.

      • Wählen Sie Wählen Sie eine SQS Amazon-Warteschlange in einem anderen AWS Konto als Warteschlange für eingehende Briefe aus und geben Sie dann die ARN Warteschlange ein, die Sie verwenden möchten. Sie müssen der Warteschlange eine ressourcenbasierte Richtlinie hinzufügen, die das Senden von Nachrichten an die Warteschlange EventBridge gestattet.

        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 Dienst angezeigt werden.

    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 — sendet EventBridge nur den angegebenen Teil des ursprünglichen Quellereignisses an das Ziel.

        Geben Sie unter Geben Sie den Teil des übereinstimmenden Ereignisses an einen JSON Pfad an, der den Teil des Ereignisses definiert EventBridge , den Sie an das Ziel senden möchten.

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

        Geben Sie unter Konstante angeben in JSON den JSON Text an, den Sie an das Ziel statt an das Ereignis senden möchten EventBridge .

      • Eingangstransformator — Konfigurieren Sie einen Eingangstransformator, um den Text, den Sie an das Ziel EventBridge senden möchten, anzupassen. Weitere Informationen finden Sie unter Transformation Amazon EventBridge Amazon-Eingaben.

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

        2. Konfigurieren Sie den Eingabe-Transformator wie unter Konfiguration eines Eingangstransformators beim Erstellen einer Regel in EventBridge beschrieben.

    2. (Optional) Geben Sie unter Wiederholungsrichtlinie an, wie erneut versucht EventBridge werden soll, ein Ereignis an ein Ziel zu senden, nachdem ein Fehler aufgetreten ist.

      • Maximales Alter des Ereignisses — Geben Sie die maximale Dauer (in Stunden, Minuten und Sekunden) ein, für die unverarbeitete Ereignisse aufbewahrt werden EventBridge sollen. Die Standardeinstellung ist 24 Stunden.

      • Wiederholungsversuche — Geben Sie ein, wie oft nach dem Auftreten eines Fehlers maximal versucht werden EventBridge soll, ein Ereignis an das Ziel zu senden. Die Standardeinstellung ist 185 Mal.

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

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

      • Wählen Sie Wählen Sie eine SQS Amazon-Warteschlange im aktuellen AWS Konto aus, die als Warteschlange für eingehende Briefe verwendet werden soll, und wählen Sie dann die zu verwendende Warteschlange aus der Drop-down-Liste aus.

      • Wählen Sie Wählen Sie eine SQS Amazon-Warteschlange in einem anderen AWS Konto als Warteschlange für eingehende Briefe aus und geben Sie dann die ARN Warteschlange ein, die Sie verwenden möchten. Sie müssen der Warteschlange eine ressourcenbasierte Richtlinie hinzufügen, die das Senden von Nachrichten an die Warteschlange EventBridge gestattet.

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

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 Ressourcen in Amazon taggen EventBridge.

  2. Wählen Sie 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.