OnSuccess

Destinazione per gli eventi che sono stati elaborati correttamente.

Sintassi

Per dichiarare questa entità nel tuoAWS Serverless Application Model(AWS SAM) template, utilizzare la seguente sintassi.

YAML

  Destination: String
  Type: String

Proprietà

Destination

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

Type: Stringa

Campo obbligatorio: Condizionale

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

Note aggiuntive: Se il tipo è Lambda/EventBridge, è obbligatoria Destinazione.

Type

Tipo di risorsa a cui fa riferimento nella destinazione. I tipi supportati sono:SQS,SNS,Lambda, eEventBridge.

Type: Stringa

Campo obbligatorio: No

AWS CloudFormationcompatibilità: Questa struttura è univoco perAWS SAMe non ha unAWS CloudFormationequivalente.

Note aggiuntive: Se il tipo è SQS/SNS e ilDestinationla proprietà viene lasciata vuota, quindi la risorsa SQS/SNS viene generata automaticamente da SAM. Per fare riferimento alla risorsa, utilizzare<function-logical-id>.DestinationQueueper SQS o<function-logical-id>.DestinationTopicper SNS. Se il tipo è Lambda/EventBridge,Destinationè obbligatorio.

Esempi

Esempio di configurazione EventInvoke con destinazioni SQS e Lambda

In questo esempio non viene fornita alcuna destinazione per la configurazione SQS OnSuccess, pertanto SAM crea implicitamente una coda SQS e aggiunge tutte le autorizzazioni necessarie. Anche per questo esempio, nella configurazione OnFailure viene specificata una Destinazione per una risorsa Lambda dichiarata nel file modello, pertanto 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. 

Esempio di configurazione di EventInvoke con destinazione SNS

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

YAML

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