DeadLetterConfig - AWS Serverless Application Model
語法屬性範例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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 SAM Type創建無效字母隊列的自定義名稱。

注意

如果未設定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