DeadLetterConfig

用於指定 Amazon Simple Queue Service (Amazon SQS) 佇列的物件，在目標叫用失敗後 EventBridge 傳送事件。例如，當將事件傳送至不存在的 Lambda 函數，或權限不足以叫用 Lambda 函數時，呼叫可能會失敗。如需詳細資訊，請參閱 Amazon 使用 EventBridge 者指南中的事件重試政策和使用無效字母佇列。

注意

資AWS::Serverless::Function源類型具有類似的資料類型，DeadLetterQueue可處理成功叫用目標 Lambda 函數之後發生的失敗。此類失敗的範例包括 Lambda 節流，或 Lambda 目標函數傳回的錯誤。如需有關函數DeadLetterQueue屬性的詳細資訊，請參閱AWS Lambda開發人員指南中的無效字母佇列。

語法

若要在 AWS Serverless Application Model (AWS SAM) 範本中宣告此實體，請使用下列語法。

YAML

  Arn: String
  QueueLogicalId: String
  Type: String

屬性

Arn

Amazon SQS 佇列的亞馬遜資源名稱 (ARN) 指定為無效字母佇列的目標。

注意

指定Type性質或Arn性質，但不能同時指定兩者。

類型：字串

必要：否

AWS CloudFormation兼容性：此屬性直接傳遞給AWS::Events::RuleDeadLetterConfig數據類型的Arn屬性。

QueueLogicalId

如果指定，則AWS SAMType創建無效字母隊列的自定義名稱。

注意

如果未設定Type屬性，則會忽略此屬性。

類型：字串

必要：否

AWS CloudFormation兼容性：此屬性是唯一的，AWS SAM並且沒有相AWS CloudFormation等的屬性。

Type

佇列的類型。設定此屬性時，AWS SAM會自動建立無效字母佇列，並附加必要的資源型政策，以授與規則資源的權限，以便將事件傳送至佇列。

注意

指定Type性質或Arn性質，但不能同時指定兩者。

有效值：SQS

類型：字串

必要：否

AWS CloudFormation兼容性：此屬性是唯一的，AWS SAM並且沒有相AWS CloudFormation等的屬性。

範例

DeadLetterConfig

DeadLetterConfig

YAML

DeadLetterConfig:
  Type: SQS
  QueueLogicalId: MyDLQ