DeadLetterConfig - AWS Serverless Application Model
SyntaxePropriétésExemples

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

DeadLetterConfig

L'objet utilisé pour spécifier la file d'attente Amazon Simple Queue Service (Amazon SQS) EventBridge où envoie les événements après l'échec d'un appel cible. L'appel peut échouer, par exemple, lors de l'envoi d'un événement à une fonction Lambda qui n'existe pas, ou en cas d'autorisations insuffisantes pour appeler la fonction Lambda. Pour plus d'informations, consultez la politique relative aux nouvelles tentatives relatives aux événements et l'utilisation des files d'attente contenant des lettres mortes dans le guide de l'utilisateur Amazon. EventBridge

Note

Le type de ressource AWS::Serverless::Function a un type de données similaire, DeadLetterQueue, qui gère les échecs qui se produisent après l'appel réussi de la fonction Lambda cible. Des exemples de ce type de défaillance incluent la limitation Lambda ou les erreurs renvoyées par la fonction cible Lambda. Pour en savoir plus sur la propriété de fonction DeadLetterQueue, consultez File d'attente de lettres mortes dans le Guide du développeur AWS Lambda.

Syntaxe

Pour déclarer cette entité dans votre modèle AWS Serverless Application Model (AWS SAM), utilisez la syntaxe suivante :

YAML

  Arn: String
  QueueLogicalId: String
  Type: String

Propriétés

Arn

L'Amazon Resource Name (ARN) de la file d'attente Amazon SQS spécifiée comme cible pour la file d'attente de lettres mortes.

Note

Spécifiez la propriété Type ou la propriété Arn, mais pas les deux.

Type : chaîne

Obligatoire : non

Compatibilité AWS CloudFormation : cette propriété est directement transmise à la propriété Arn du type de données AWS::Events::Rule DeadLetterConfig.

QueueLogicalId

Le nom personnalisé de la file d'attente de lettres mortes que AWS SAM crée siType est spécifié.

Note

Si la propriété Type n'est pas définie, cette propriété est ignorée.

Type : chaîne

Obligatoire : non

Compatibilité AWS CloudFormation : cette propriété est unique pour AWS SAM et ne dispose pas d'équivalent AWS CloudFormation.

Type

Type de la file d'attente. Lorsque cette propriété est définie, AWS SAM crée automatiquement une file d'attente de lettres mortes et attache la Stratégie basée sur les ressources nécessaire pour accorder l'autorisation à la ressource de règle pour envoyer des événements à la file d'attente.

Note

Spécifiez la propriété Type ou la propriété Arn, mais pas les deux.

Valeurs valides : SQS

Type : chaîne

Obligatoire : non

Compatibilité AWS CloudFormation : cette propriété est unique pour AWS SAM et ne dispose pas d'équivalent AWS CloudFormation.

Exemples

DeadLetterConfig

DeadLetterConfig

YAML

DeadLetterConfig:
  Type: SQS
  QueueLogicalId: MyDLQ