DeadLetterConfig - Amazon Serverless Application Model
语法属性示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

DeadLetterConfig

用于指定目标调用失败后 EventBridge 发送事件的 Amazon Simple Queueueue Service (Amazon SQS) 队列。例如，向不存在的 Lambda 函数发送事件，或者权限不足以调用 Lambda 函数时，调用可能会失败。有关更多信息，请参阅 Amazon EventBridge 用户指南中的事件重试策略和使用死信队列。

注意

AWS::Serverless::Function资源类型具有相似的数据类型DeadLetterQueue，用于处理成功调用目标 Lambda 函数后发生的故障。此类故障的示例包括 Lambda 限制或 Lambda 目标函数返回的错误。有关函数DeadLetterQueue属性的更多信息，请参阅Amazon Lambda开发者指南中的Amazon Lambda函数死信队列。

语法

要在Amazon Serverless Application Model (Amazon SAM) 模板中声明此实体，请使用以下语法。

YAML

  Arn: String
  QueueLogicalId: String
  Type: String

属性

Arn

指定作为死信队列的目标的 Amazon SQS 队列的目标的 Amazon SQS 队列（ARN）。

注意

指定两者TypeArn，但不能同时指定两者。

类型：字符串

必填项：否

Amazon CloudFormation兼容性：此属性直接传递给AWS::Events::RuleDeadLetterConfig数据类型的Arn属性。

QueueLogicalId

如果已指定，则Amazon SAM创建的死信队列Type的自定义名称。

注意

如果未设置该Type属性，则将忽略该属性。

类型：字符串

必填项：否

Amazon CloudFormation兼容性：此属性是独一无二的Amazon SAM，没有Amazon CloudFormation等效属性。

Type

队列。设置此属性后，Amazon SAM会自动创建死信队列并附加必要的基于资源的策略，以授予规则资源向队列发送事件的权限。

注意

指定两者TypeArn，但不能同时指定两者。

有效值：SQS

类型：字符串

必填项：否

Amazon CloudFormation兼容性：此属性是独一无二的Amazon SAM，没有Amazon CloudFormation等效属性。

示例

DeadLetterConfig

DeadLetterConfig

YAML

DeadLetterConfig:
  Type: SQS
  QueueLogicalId: MyDLQ