DeadLetterConfig

El objeto utilizado para especificar la cola del Amazon Simple Queue Service (Amazon SQS) desde la que EventBridge se envían los eventos tras una invocación de destino fallida. La invocación puede fallar, por ejemplo, al enviar un evento a una función de Lambda que no existe o cuando EventBridge no tiene permisos suficientes para invocar la función de Lambda. Para obtener más información, consulta la política de reintentos de eventos y el uso de colas con letra muerta en la Guía del usuario de Amazon. EventBridge

nota

El tipo de recurso AWS::Serverless::Function tiene un tipo de datos similar, DeadLetterQueue, que gestiona los errores que se producen tras la invocación correcta de la función de Lambda de destino. Entre los ejemplos de este tipo de errores se incluyen la limitación de Lambda o los errores devueltos por la función de destino de Lambda. Para obtener más información sobre la propiedad DeadLetterQueue de la función, consulte Colas de mensajes fallidos en la AWS Lambda Guía para desarrolladores.

Sintaxis

Para declarar esta entidad en tu plantilla AWS Serverless Application Model (AWS SAM), usa la siguiente sintaxis.

YAML

  Arn: String
  QueueLogicalId: String
  Type: String

Propiedades

Arn

El nombre de recurso de Amazon (ARN) de la cola SQS de Amazon especificada como destino de la cola de mensajes fallidos.

nota

Especifique la propiedad Type o la propiedad Arn, pero no ambas.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la Arn propiedad del tipo de AWS::Events::Rule DeadLetterConfig datos.

QueueLogicalId

TypeSe especifica el nombre personalizado de la cola de cartas muertas que la AWS SAM crea.

nota

Si no se especifica la propiedad Type, entonces esta propiedad se pasa por alto.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad es exclusiva de AWS SAM y no tiene un AWS CloudFormation equivalente.

Type

Tipo de cola. Cuando se establece esta propiedad, crea AWS SAM automáticamente una cola sin efecto y adjunta la política basada en los recursos necesaria para conceder permiso al recurso de regla para enviar eventos a la cola.

nota

Especifique la propiedad Type o la propiedad Arn, pero no ambas.

Valores válidos: SQS

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad es exclusiva y no tiene un equivalente. AWS SAM AWS CloudFormation

Ejemplos

DeadLetterConfig

DeadLetterConfig

YAML

DeadLetterConfig:
  Type: SQS
  QueueLogicalId: MyDLQ