Schedule - AWS Serverless Application Model
SyntaxEigenschaftenBeispiele

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.

Schedule

Das Objekt, das einen Schedule Ereignisquellentyp beschreibt, der Ihre serverlose Funktion als Ziel einer EventBridge Amazon-Regel festlegt, die nach einem Zeitplan ausgelöst wird. Weitere Informationen finden Sie unter Was ist Amazon EventBridge? im EventBridge Amazon-Benutzerhandbuch.

AWS Serverless Application Model (AWS SAM) generiert eine AWS::Events::RuleRessource, wenn dieser Ereignistyp gesetzt ist.

Anmerkung

EventBridge bietet jetzt eine neue Planungsfunktion, Amazon EventBridge Scheduler. Amazon EventBridge Scheduler ist ein serverloser Scheduler, 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 EventBridge geplanten Regeln mit einem breiteren Spektrum an Ziel-API-Vorgängen und AWS-Services.

Wir empfehlen Ihnen, Folgendes zu verwenden EventBridge Scheduler um Ziele nach einem Zeitplan aufzurufen. Informationen zur Definition dieses Ereignisquellentyps in Ihren AWS SAM Vorlagen finden Sie unterScheduleV2.

Syntax

Verwenden Sie die folgende Syntax, um diese Entität in Ihrer Vorlage AWS Serverless Application Model (AWS SAM) zu deklarieren.

YAML

  DeadLetterConfig: DeadLetterConfig
  Description: String
  Enabled: Boolean
  Input: String
  Name: String
  RetryPolicy: RetryPolicy
  Schedule: String
  State: String

Eigenschaften

DeadLetterConfig

Konfigurieren Sie die Amazon Simple Queue Service (Amazon SQS) -Warteschlange, über die Ereignisse nach einem fehlgeschlagenen Zielaufruf EventBridge gesendet werden. Der Aufruf kann beispielsweise fehlschlagen, wenn ein Ereignis an eine Lambda-Funktion gesendet wird, die nicht existiert, oder wenn EventBridge nicht genügend Berechtigungen zum Aufrufen der Lambda-Funktion vorhanden sind. Weitere Informationen finden Sie unter Richtlinien zur Wiederholung von Ereignissen und Verwenden von Warteschlangen mit unerlaubten Briefen im Amazon-Benutzerhandbuch. EventBridge

Anmerkung

Der AWS::Serverless::Function Ressourcentyp hat einen ähnlichen DatentypDeadLetterQueue, der Fehler behandelt, die nach einem erfolgreichen Aufruf der Lambda-Zielfunktion auftreten. Beispiele für diese Arten von Fehlern sind Lambda-Drosselung oder Fehler, die von der Lambda-Zielfunktion zurückgegeben werden. Weitere Informationen zur DeadLetterQueue Funktionseigenschaft finden Sie im Developer Guide unter Warteschlangen mit uneingeschränktem Inhalt.AWS Lambda

Typ: DeadLetterConfig

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft ähnelt der DeadLetterConfig Eigenschaft des Datentyps. AWS::Events::Rule Target Die AWS SAM Version dieser Eigenschaft enthält zusätzliche Untereigenschaften für den Fall, dass Sie die Warteschlange AWS SAM für unzustellbare Briefe erstellen möchten.

Description

Eine Beschreibung der Regel.

Typ: Zeichenfolge

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die Description Eigenschaft einer AWS::Events::Rule Ressource übergeben.

Enabled

Gibt an, ob die Regel aktiviert ist.

Um die Regel zu deaktivieren, setzen Sie diese Eigenschaft auffalse.

Anmerkung

Geben Sie entweder die State Eigenschaft Enabled oder an, aber nicht beide.

Typ: Boolesch

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft ähnelt der State Eigenschaft einer AWS::Events::Rule Ressource. Wenn diese Eigenschaft auf true gesetzt ist, gilt sie AWS SAM als erfolgreichENABLED, andernfalls gilt sie als erfolgreichDISABLED.

Input

Gültiger JSON-Text wurde an das Ziel übergeben. Wenn Sie diese Eigenschaft verwenden, wird nichts aus dem Ereignistext selbst an das Ziel weitergeleitet.

Typ: Zeichenfolge

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die Input Eigenschaft einer AWS::Events::Rule Target Ressource übergeben.

Name

Der Name der Regel. Wenn Sie keinen Namen angeben, CloudFormation generiert es eine eindeutige physische ID und verwendet diese ID als Regelnamen.

Typ: Zeichenfolge

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die Name Eigenschaft einer AWS::Events::Rule Ressource übergeben.

RetryPolicy

Ein RetryPolicy-Objekt, das Informationen zu den Richtlinieneinstellungen für Wiederholungsversuche enthält. Weitere Informationen finden Sie unter Richtlinien zur Wiederholung von Ereignissen und Verwenden von Warteschlangen mit unerlaubten Briefen im Amazon-Benutzerhandbuch. EventBridge

Typ: RetryPolicy

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die RetryPolicy Eigenschaft des Datentyps übergeben. AWS::Events::Rule Target

Schedule

Der Planungsausdruck, der bestimmt, wann und wie oft die Regel ausgeführt wird. Weitere Informationen finden Sie unter Planen von Ausdrücken für Regeln.

Typ: Zeichenfolge

Erforderlich: Ja

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die ScheduleExpression Eigenschaft einer AWS::Events::Rule Ressource übergeben.

State

Der Status der Regel.

Zulässige Werte: DISABLED | ENABLED

Anmerkung

Geben Sie entweder die State Eigenschaft Enabled oder an, aber nicht beide.

Typ: Zeichenfolge

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die State Eigenschaft einer AWS::Events::Rule Ressource übergeben.

Beispiele

CloudWatch Veranstaltung planen

CloudWatch Beispiel für einen Termin planen

YAML

CWSchedule:
  Type: Schedule
  Properties:
    Schedule: 'rate(1 minute)'
    Name: TestSchedule
    Description: test schedule
    Enabled: false