Voraussetzungen Verwenden der Konsole Mit dem AWS CLI Mit dem SDKs Als nächstes

Erste Schritte mit EventBridge Scheduler

In diesem Thema wird die Erstellung eines neuen EventBridge Scheduler-Zeitplans beschrieben. Sie verwenden die EventBridge Scheduler-Konsole, AWS Command Line Interface (AWS CLI), oder, AWS SDKs um einen Zeitplan mit einem vordefinierten SQS Amazon-Ziel zu erstellen. Anschließend richten Sie die Protokollierung ein, konfigurieren Wiederholungsversuche und legen eine maximale Aufbewahrungszeit für fehlgeschlagene Aufgaben fest. Nachdem Sie den Zeitplan erstellt haben, überprüfen Sie, ob Ihr Zeitplan das Ziel erfolgreich aufruft und eine Nachricht an die Zielwarteschlange sendet.

Anmerkung

Um diesem Leitfaden zu folgen, empfehlen wir Ihnen, IAM Benutzer mit den unter beschriebenen Mindestberechtigungen einzurichten. Verwendung identitätsbasierter Richtlinien im Scheduler EventBridge Nachdem Sie einen Benutzer erstellt und konfiguriert haben, führen Sie den folgenden Befehl aus, um Ihre Zugangsdaten festzulegen. Sie benötigen Ihre Zugriffsschlüssel-ID und Ihren geheimen Zugriffsschlüssel, um den zu konfigurieren AWS CLI.


$ aws configure
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Default region name [None]: us-west-2
Default output format [None]: json

Weitere Informationen zu den verschiedenen Möglichkeiten, wie Sie Ihre Anmeldeinformationen festlegen können, finden Sie unter Konfigurationseinstellungen und Rangfolge im AWS Command Line Interface Benutzerhandbuch für Version 2.

Themen

Voraussetzungen
Erstellen Sie mit der EventBridge Scheduler-Konsole einen Zeitplan
Erstellen Sie einen Zeitplan mit AWS CLI
Erstellen Sie mit dem Scheduler einen Zeitplan EventBridge SDKs
Als nächstes

Voraussetzungen

Bevor Sie die Schritte in diesem Abschnitt ausführen, müssen Sie Folgendes tun:

Führen Sie die unter beschriebenen Aufgaben aus Amazon EventBridge Scheduler einrichten

Erstellen Sie mit der EventBridge Scheduler-Konsole einen Zeitplan

So erstellen Sie einen neuen Zeitplan mithilfe der Konsole

Melden Sie sich bei der an und wählen Sie dann den folgenden Link AWS Management Console, um den EventBridge Scheduler-Bereich der EventBridge Konsole zu öffnen: Home? https://us-west-2.console.aws.amazon.com/scheduler/ region=us-west-2 #home

Anmerkung
Sie können Ihre ändern, AWS-Region indem Sie die Regionsauswahl von verwenden. AWS Management Console
Wählen Sie auf der Seite Zeitpläne die Option Zeitplan erstellen aus.
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. Geben Sie unter Beschreibung — optional eine Beschreibung für Ihren Zeitplan ein. Beispiel, My first schedule.
3. Wählen Sie unter Zeitplangruppe eine Zeitplangruppe aus den Drop-down-Optionen aus. Wenn Sie noch keine Zeitplangruppen erstellt haben, können Sie die default Gruppe für Ihren Zeitplan auswählen. Um eine neue Zeitplangruppe zu erstellen, klicken Sie in der Konsolenbeschreibung auf den Link Eigenen Zeitplan erstellen. Sie verwenden Zeitplangruppen, um Tags zu Zeitplangruppen hinzuzufügen.
Gehen Sie im Abschnitt Zeitplanmuster wie folgt vor:
1. Wählen Sie für Vorkommen eine der folgenden Musteroptionen aus. Die Konfigurationsoptionen ändern sich je nachdem, welches Muster Sie auswählen.
  - Einmaliger Zeitplan — Ein einmaliger Zeitplan ruft ein Ziel nur einmal an dem von Ihnen angegebenen Datum und zu der von Ihnen angegebenen Uhrzeit auf.
    
    Geben Sie für Datum und Uhrzeit ein gültiges Datum im YYYY/MM/DD Format ein. Geben Sie dann einen Zeitstempel im hh:mm 24-Stunden-Format an. Wählen Sie abschließend eine Zeitzone aus den Drop-down-Optionen aus.
  - Wiederkehrender Zeitplan — Ein wiederkehrender Zeitplan ruft ein Ziel mit einer Geschwindigkeit auf, die Sie mithilfe eines cron Ausdrucks oder eines Kursausdrucks angeben.
    
    Wählen Sie einen Cron-basierten Zeitplan, um einen Zeitplan mithilfe eines Ausdrucks zu konfigurieren. cron Um einen Preisausdruck zu verwenden, wählen Sie Ratenbasierter Zeitplan und geben Sie eine positive Zahl für Wert ein. Wählen Sie dann eine Einheit aus den Dropdownoptionen aus.
  Weitere Informationen zur Verwendung von Cron- und Ratenausdrücken finden Sie unter. Zeitplantypen im EventBridge Scheduler
2. Wählen Sie für „Flexibles Zeitfenster“ die Option „Aus“, um die Option zu deaktivieren, oder wählen Sie eines der vordefinierten Zeitfenster aus der Dropdownliste. 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.
Wenn Sie im vorherigen Schritt Wiederkehrender Zeitplan ausgewählt haben, geben Sie im Abschnitt Zeitrahmen eine Zeitzone an und legen Sie optional ein Startdatum und eine Startzeit sowie ein Enddatum und eine Endzeit für den Zeitplan fest. Ein wiederkehrender Zeitplan ohne Startdatum beginnt, sobald er erstellt und verfügbar ist. Bei wiederkehrenden Zeitplänen ohne Enddatum wird das Ziel weiterhin auf unbestimmte Zeit aktiviert.
Wählen Sie Weiter.
Auf der Seite Ziel auswählen gehen Sie wie folgt vor:
1. Wählen Sie Ziele mit Vorlagen und wählen Sie ein Ziel aus. API In diesem Beispiel wählen wir das SQSSendMessageAmazon-Vorlagenziel aus.
2. Wählen Sie im SendMessageAbschnitt SQSWarteschlange eine bestehende SQS Amazon-Warteschlange aus, ARN z. B. arn:aws:sqs:us-west-2:123456789012:TestQueue aus der Drop-down-Liste. Um eine neue Warteschlange zu erstellen, wählen Sie Neue SQS Warteschlange erstellen, um zur SQS Amazon-Konsole zu navigieren. Wenn Sie mit dem Erstellen einer Warteschlange fertig sind, kehren Sie zur EventBridge Scheduler-Konsole zurück und aktualisieren Sie das Drop-down-Menü. Ihre neue Warteschlange ARN wird angezeigt und kann ausgewählt werden.
3. Geben Sie für Target die Payload ein, die EventBridge Scheduler an das Ziel liefern soll. In diesem Beispiel senden wir die folgende Nachricht an die Zielwarteschlange: Hello, it's EventBridge Scheduler.
Wählen Sie Weiter und gehen Sie dann auf der Seite Einstellungen — optional wie folgt vor:
1. Schalten Sie im Abschnitt Zeitplanstatus unter Zeitplan aktivieren die Funktion mithilfe des Schalters ein oder aus. Standardmäßig aktiviert der EventBridge Scheduler Ihren Zeitplan.
2. Konfigurieren Sie im Abschnitt Aktion nach Abschluss des Zeitplans die Aktion, die der EventBridge Scheduler nach Abschluss des Zeitplans ausführt:
  - Wählen Sie aus, DELETEob der Zeitplan automatisch gelöscht werden soll. Bei einmaligen Zeitplänen erfolgt dies, nachdem der Zeitplan das Ziel einmal aufgerufen hat. Bei wiederkehrenden Zeitplänen erfolgt dies nach dem letzten geplanten Aufruf des Zeitplans. Weitere Hinweise zum automatischen Löschen finden Sie unterLöschen nach Abschluss des Zeitplans.
  - Wählen Sie einen Wert NONE, oder wählen Sie keinen Wert, wenn Sie nicht möchten, dass der EventBridge Scheduler nach Abschluss des Zeitplans weitere Aktionen ausführt.
3. Aktivieren Sie im Abschnitt Wiederholungsrichtlinie und Warteschlange für unzustellbare Briefe (DLQ) für Wiederholungsrichtlinie die Option Wiederholen, um eine Wiederholungsrichtlinie für Ihren Zeitplan zu konfigurieren. 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.
4. Geben Sie unter Maximales Alter des Ereignisses — optional die maximale (n) Stunde (n) und Minute (n) ein, für die der EventBridge Scheduler ein unbearbeitetes Ereignis speichern muss.
  
  Anmerkung
  Der Höchstwert ist 24 Stunden.
5. Geben Sie unter Maximale Anzahl an Wiederholungen ein, wie oft der EventBridge Scheduler den Zeitplan maximal wiederholt, wenn das Ziel einen Fehler zurückgibt.
  
  Anmerkung
  Der Maximalwert beträgt 185 Wiederholungen.
6. Wählen Sie für Dead-Letter-Warteschlange (DLQ) eine der folgenden Optionen aus:
  - Keine — Wählen Sie diese Option, wenn Sie keine konfigurieren möchten. DLQ
  - Wählen Sie in meinem AWS Konto eine SQS Amazon-Warteschlange aus als DLQ — Wählen Sie diese Option, wählen Sie dann eine Warteschlange ARN aus der Drop-down-Liste aus und konfigurieren Sie dieselbe AWS-Konto wie die, in der Sie den Zeitplan erstellen. DLQ
  - Geben Sie eine SQS Amazon-Warteschlange in einem anderen AWS Konto an als DLQ — Wählen Sie diese Option und geben Sie dann die als konfigurierte Warteschlange einDLQ, falls sich die Warteschlange in einer anderen befindet AWS-Konto. ARN Sie müssen den genauen Wert ARN für die Warteschlange eingeben, um diese Option verwenden zu können.
7. Wählen Sie im Bereich Verschlüsselung die Option Verschlüsselungseinstellungen anpassen (erweitert), um Ihre Zieleingabe mit einem vom Kunden verwalteten KMS Schlüssel zu verschlüsseln. Wenn Sie diese Option wählen, geben Sie einen vorhandenen KMS Schlüssel ein ARN oder wählen Sie AWS KMS Schlüssel erstellen, 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 EventBridge Scheduler
8. Wählen Sie für Berechtigungen die Option Bestehende Rolle verwenden aus und wählen Sie dann die Rolle, die Sie während des Einrichtungsvorgangs erstellt haben, aus der Dropdownliste aus. Sie können auch „Gehe zur IAM Konsole“ wählen, um eine neue Rolle zu erstellen.
  
  Wenn Sie möchten, dass EventBridge Scheduler eine neue Ausführungsrolle für Sie erstellt, wählen Sie stattdessen Neue Rolle für diesen Zeitplan erstellen. Geben Sie dann einen Namen für Rollenname ein. Wenn Sie diese Option wählen, fügt EventBridge Scheduler der Rolle die erforderlichen Berechtigungen hinzu, die für Ihr vorgegebenes Ziel erforderlich sind.
Wählen Sie Weiter.
Ü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.
Wählen Sie Zeitplan erstellen aus, um die Erstellung Ihres neuen Zeitplans abzuschließen. 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 Ihr Zeitplan das SQS Amazon-Ziel aufruft, öffnen Sie die SQS Amazon-Konsole und gehen Sie wie folgt vor:
1. Wählen Sie die Zielwarteschlange aus der Warteschlangenliste aus.
2. Wählen Sie Nachrichten senden und empfangen.
3. Wählen Sie auf der Seite Nachrichten senden und empfangen unter Nachrichten empfangen die Option Nachrichten abfragen aus, um die Testnachrichten abzurufen, die Ihr Zeitplan an die Zielwarteschlange gesendet hat.

Erstellen Sie einen Zeitplan mit AWS CLI

Das folgende Beispiel zeigt, wie Sie den AWS CLI Befehl verwenden create-schedule, um einen EventBridge Scheduler-Zeitplan mit einem vordefinierten SQS Amazon-Ziel zu erstellen. Ersetzen Sie die Platzhalterwerte für die folgenden Parameter durch Ihre Informationen:

--name — Geben Sie einen Namen für den Zeitplan ein.
RoleArn— Geben Sie ARN die Ausführungsrolle ein, die Sie dem Zeitplan zuordnen möchten.
Arn — Geben Sie den ARN für das Ziel ein. In diesem Fall ist das Ziel eine SQS Amazon-Warteschlange.
Eingabe — Geben Sie eine Nachricht ein, die EventBridge Scheduler an die Zielwarteschlange übermittelt.


$ aws scheduler create-schedule --name sqs-templated-schedule --schedule-expression 'rate(5 minutes)' \
--target '{"RoleArn": "ROLE_ARN", "Arn": "QUEUE_ARN", "Input": "TEST_PAYLOAD" }' \
--flexible-time-window '{ "Mode": "OFF"}'

Erstellen Sie mit dem Scheduler einen Zeitplan EventBridge SDKs

Im folgenden Beispiel verwenden Sie den EventBridge Scheduler, SDKs um einen EventBridge Scheduler-Zeitplan mit einem vordefinierten Amazon-Ziel zu erstellen. SQS

Beispiel Python SDK


import boto3
scheduler = boto3.client('scheduler')

flex_window = { "Mode": "OFF" }

sqs_templated = {
    "RoleArn": "<ROLE_ARN>",
    "Arn": "<QUEUE_ARN>",
    "Input": "Message for scheduleArn: '<aws.scheduler.schedule-arn>', scheduledTime: '<aws.scheduler.scheduled-time>'"
}

scheduler.create_schedule(
    Name="sqs-python-templated",
    ScheduleExpression="rate(5 minutes)",
    Target=sqs_templated,
    FlexibleTimeWindow=flex_window)

Beispiel Java SDK


package com.example;

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.scheduler.SchedulerClient;
import software.amazon.awssdk.services.scheduler.model.*;


public class MySchedulerApp {

    public static void main(String[] args) {
        
        final SchedulerClient client = SchedulerClient.builder()
                .region(Region.US_WEST_2)
                .build();
        
        Target sqsTarget = Target.builder()
                .roleArn("<ROLE_ARN>")
                .arn("<QUEUE_ARN>")
                .input("Message for scheduleArn: '<aws.scheduler.schedule-arn>', scheduledTime: '<aws.scheduler.scheduled-time>'")
                .build();
        
        CreateScheduleRequest createScheduleRequest = CreateScheduleRequest.builder()
                .name("<SCHEDULE NAME>")
                .scheduleExpression("rate(10 minutes)")
                .target(sqsTarget)
                .flexibleTimeWindow(FlexibleTimeWindow.builder()
                        .mode(FlexibleTimeWindowMode.OFF)
                        .build())
                .build();
                
        client.createSchedule(createScheduleRequest);
        System.out.println("Created schedule with rate expression and an Amazon SQS templated target");
    }
}

Als nächstes

Weitere Informationen zur Verwaltung Ihres Zeitplans mit der Konsole oder dem EventBridge Scheduler finden Sie SDK unterVerwaltung eines Zeitplans im EventBridge Scheduler. AWS CLI
Weitere Informationen zur Konfiguration von Zielvorlagen und zur Verwendung des Parameters Universal Target finden Sie unter. Ziele im EventBridge Scheduler verwalten
Weitere Informationen zu den EventBridge Scheduler-Datentypen und API -Vorgängen finden Sie in der EventBridge APIScheduler-Referenz.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Einrichtung

Arten von Zeitplänen