DeadLetterConfig

O objeto usado para especificar a fila do Amazon Simple Queue Service (Amazon SQS) para a EventBridge qual envia eventos após uma falha na invocação de destino. A invocação pode falhar, por exemplo, ao enviar um evento para uma função do Lambda que não existe ou permissões insuficientes para invocar a função do Lambda. Para obter mais informações, consulte Política de repetição de eventos e uso de filas de mensagens mortas no Guia do usuário da Amazon. EventBridge

nota

O tipo de recurso AWS::Serverless::Function tem um tipo de dados semelhante, DeadLetterQueue que lida com falhas que ocorrem após a invocação bem-sucedida da função do Lambda de destino. Exemplos desse tipo de falha incluem controle de utilização do Lambda ou erros retornados pela função de destino do Lambda. Para obter mais informações sobre a propriedade DeadLetterQueue da função, consulte as filas de mensagens não entregues no Guia do desenvolvedor do AWS Lambda.

Sintaxe

Para declarar esta entidade no modelo do AWS Serverless Application Model (AWS SAM), use a seguinte sintaxe:

YAML

  Arn: String
  QueueLogicalId: String
  Type: String

Propriedades

Arn

O nome de recurso da Amazon (ARN) da fila Amazon SQS especificado como o destino para a fila de mensagens não entregues.

nota

Especifique a propriedade Type ou a propriedade Arn, mas não ambas.

Tipo: string

Obrigatório: não

Compatibilidade AWS CloudFormation: essa propriedade é passada diretamente para a propriedade Arn do tipo de dados AWS::Events::Rule DeadLetterConfig.

QueueLogicalId

O nome personalizado da fila de mensagens não entregues que o AWS SAM cria se Type for especificado.

nota

Se a propriedade Type não estiver definida, essa propriedade será ignorada.

Tipo: string

Obrigatório: não

Compatibilidade AWS CloudFormation: Essa propriedade é exclusiva do AWS SAM e não tem AWS CloudFormation equivalente.

Type

O tipo da fila. Quando essa propriedade é definida, o AWS SAM cria automaticamente uma fila de mensagens não entregues e anexa a política baseada em recursos necessária para conceder permissão ao recurso de regra para enviar eventos para a fila.

nota

Especifique a propriedade Type ou a propriedade Arn, mas não ambas.

Valores válidos: SQS

Tipo: string

Obrigatório: não

Compatibilidade AWS CloudFormation: Essa propriedade é exclusiva do AWS SAM e não tem AWS CloudFormation equivalente.

Exemplos

DeadLetterConfig

DeadLetterConfig

YAML

DeadLetterConfig:
  Type: SQS
  QueueLogicalId: MyDLQ