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 LambdaGuía para desarrolladores.

Sintaxis

Para declarar esta entidad en su plantilla de AWS Serverless Application Model (AWS SAM), use 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

Compatibilidad con AWS CloudFormation: esta propiedad se transfiere directamente a la propiedad Arn del tipo de datos AWS::Events::Rule DeadLetterConfig.

QueueLogicalId

Se especifica el nombre personalizado de la cola de mensajes fallidos que AWS SAM crea si se especifica Type.

nota

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

Tipo: cadena

Obligatorio: no

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

Type

Tipo de cola. Cuando se establece esta propiedad, AWS SAM crea automáticamente una cola de mensajes fallidos 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

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

Ejemplos

DeadLetterConfig

DeadLetterConfig

YAML

DeadLetterConfig:
  Type: SQS
  QueueLogicalId: MyDLQ