OnFailure

Destinazione per gli eventi la cui elaborazione non è riuscita.

Sintassi

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

YAML

  Destination: String
  Type: String

Proprietà

Destination

L'Amazon Resource Name (ARN) della risorsa di destinazione.

Tipo: stringa

Required: Conditional

AWS CloudFormationcompatibilità: Questa proprietà è simile alla OnFailure proprietà di una AWS::Lambda::EventInvokeConfig risorsa. SAM aggiungerà tutte le autorizzazioni necessarie al ruolo IAM generato automaticamente associato a questa funzione per accedere alla risorsa a cui si fa riferimento in questa proprietà.

Note aggiuntive: se il tipo è Lambda/EventBridge, è richiesta la destinazione.

Type

Tipo di risorsa a cui si fa riferimento nella destinazione. I tipi supportati sonoSQS, SNSLambda, eEventBridge.

Tipo: stringa

Required: No

AWS CloudFormationcompatibilità: questa proprietà è unica AWS SAM e non ha un AWS CloudFormation equivalente.

Note aggiuntive: se il tipo è SQS/SNS e la Destination proprietà viene lasciata vuota, la risorsa SQS/SNS viene generata automaticamente da SAM. Per fare riferimento alla risorsa, usa <function-logical-id>.DestinationQueue per SQS o per SNS. <function-logical-id>.DestinationTopic Se il tipo è Lambda/EventBridge, Destination è obbligatorio.

Esempi

EventInvoke Esempio di configurazione con destinazioni SQS e Lambda

In questo esempio non viene fornita alcuna destinazione per la OnSuccess configurazione SQS, quindi SAM crea implicitamente una coda SQS e aggiunge le autorizzazioni necessarie. Inoltre, in questo esempio, nella OnFailure configurazione viene specificata una destinazione per una risorsa Lambda dichiarata nel file modello, quindi SAM aggiunge le autorizzazioni necessarie a questa funzione Lambda per chiamare la funzione Lambda di destinazione.

YAML

EventInvokeConfig:
  DestinationConfig:
    OnSuccess:
      Type: SQS
    OnFailure:
      Type: Lambda
      Destination: !GetAtt DestinationLambda.Arn  # Arn of a Lambda function declared in the template file. 

EventInvoke Esempio di configurazione con destinazione SNS

In questo esempio viene fornita una destinazione per un argomento SNS dichiarato nel file modello per la OnSuccess configurazione.

YAML

EventInvokeConfig:
  DestinationConfig:
    OnSuccess:
      Type: SNS
      Destination:
        Ref: DestinationSNS       # Arn of an SNS topic declared in the tempate file