DeadLetterConfig - AWS Serverless Application Model
SintaxisPropiedadesEjemplos

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

DeadLetterConfig

El objeto utilizado para especificar la cola de Amazon Simple Queue Service (Amazon SQS) a la que EventBridge envía 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 Política de reintentos de eventos y uso de colas de mensajes fallidos 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, consulta Colas de mensajes fallidos en la AWS LambdaGuía para desarrolladores.

Sintaxis

Para declarar esta entidad en tu plantilla de 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

Especifica 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

Especifica 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