DeadLetterConfig

Das Objekt, das zur Angabe der Amazon Simple Queue Service (Amazon SQS)-Warteschlange verwendet wird, in der Ereignisse nach einem fehlgeschlagenen Zielaufruf EventBridge sendet. Der Aufruf kann beispielsweise fehlschlagen, wenn ein Ereignis an eine nicht vorhandene Lambda-Funktion gesendet wird oder wenn nicht genügend Berechtigungen zum Aufrufen der Lambda-Funktion vorhanden sind. Weitere Informationen finden Sie unter Richtlinie zur Wiederholung von Ereignissen und Verwendung von Warteschlangen für unzustellbare Nachrichten im Amazon EventBridge -Benutzerhandbuch.

Anmerkung

Der AWS::Serverless::Function Ressourcentyp hat einen ähnlichen Datentyp, DeadLetterQueue der Fehler behandelt, die nach erfolgreichem Aufruf der Lambda-Zielfunktion auftreten. Beispiele für diese Art von Fehlern sind Lambda-Drosselung oder Fehler, die von der Lambda-Zielfunktion zurückgegeben werden. Weitere Informationen zur -DeadLetterQueueFunktionseigenschaft finden Sie unter Warteschlangen für unzustellbare Nachrichten im -AWS LambdaEntwicklerhandbuch.

Syntax

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

YAML

  Arn: String
  QueueLogicalId: String
  Type: String

Eigenschaften

Arn

Der Amazon-Ressourcenname (ARN) der Amazon SQS-Warteschlange, die als Ziel für die Warteschlange für unzustellbare Nachrichten angegeben ist.

Anmerkung

Geben Sie entweder die -TypeEigenschaft oder -ArnEigenschaft an, aber nicht beides.

Typ: Zeichenfolge

Required: No

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

QueueLogicalId

Der benutzerdefinierte Name der Warteschlange für unzustellbare Nachrichten, die AWS SAM erstellt, wenn angegeben Type ist.

Anmerkung

Wenn die -TypeEigenschaft nicht festgelegt ist, wird diese Eigenschaft ignoriert.

Typ: Zeichenfolge

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft ist eindeutig für AWS SAM und hat kein AWS CloudFormationÄquivalent.

Type

Der Typ der Warteschlange. Wenn diese Eigenschaft festgelegt ist, erstellt AWS SAM automatisch eine Warteschlange für unzustellbare Nachrichten und fügt die erforderliche ressourcenbasierte Richtlinie an, um der Regelressource die Berechtigung zum Senden von Ereignissen an die Warteschlange zu erteilen.

Anmerkung

Geben Sie entweder die -TypeEigenschaft oder -ArnEigenschaft an, aber nicht beides.

Gültige Werte: SQS

Typ: Zeichenfolge

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft ist eindeutig für AWS SAM und hat kein AWS CloudFormationÄquivalent.

Beispiele

DeadLetterConfig

DeadLetterConfig

YAML

DeadLetterConfig:
  Type: SQS
  QueueLogicalId: MyDLQ