OnFailure - AWS Serverless Application Model
SintaksPropertiContoh

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

OnFailure

Tujuan untuk peristiwa yang gagal diproses.

Sintaks

Untuk mendeklarasikan entitas ini dalam template AWS Serverless Application Model (AWS SAM) Anda, gunakan sintaks berikut.

YAML

  Destination: String
  Type: String

Properti

Destination

Amazon Resource Name (ARN) dari sumber daya tujuan.

Tipe: String

Wajib: Bersyarat

AWS CloudFormation kompatibilitas: Properti ini mirip dengan OnFailure properti AWS::Lambda::EventInvokeConfig sumber daya. SAM akan menambahkan izin yang diperlukan untuk membuat IAM role yang dibuat secara otomatis terkait dengan fungsi ini untuk mengakses sumber daya yang dirujuk dalam properti ini.

Catatan tambahan: Jika jenisnya adalah Lambda/EventBridge, Tujuan diperlukan.

Type

Tipe sumber daya yang dirujuk di tujuan. Tipe yang didukung adalah SQS, SNS, Lambda, dan EventBridge.

Tipe: String

Wajib: Tidak

AWS CloudFormation kompatibilitas: Properti ini unik AWS SAM dan tidak memiliki AWS CloudFormation padanan.

Catatan tambahan: Jika tipe SQS/SNS dan properti Destination dibiarkan kosong, sumber daya SQS/SNS otomatis dibuat oleh SAM. Untuk referensi sumber daya, gunakan <function-logical-id>.DestinationQueue untuk SQS atau <function-logical-id>.DestinationTopic untuk SNS. Jika jenisnya adalah Lambda/EventBridge, Destination diperlukan.

Contoh

EventInvoke Contoh Konfigurasi dengan tujuan SQS dan Lambda

Dalam contoh ini tidak ada Tujuan yang diberikan untuk OnSuccess konfigurasi SQS, sehingga SAM secara implisit membuat antrian SQS dan menambahkan izin yang diperlukan. Juga untuk contoh ini, Tujuan untuk sumber daya Lambda yang dideklarasikan dalam file template ditentukan dalam OnFailure konfigurasi, jadi SAM menambahkan izin yang diperlukan ke fungsi Lambda ini untuk memanggil fungsi Lambda tujuan.

YAML

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

EventInvoke Contoh Konfigurasi dengan tujuan SNS

Dalam contoh ini Tujuan diberikan untuk topik SNS yang dideklarasikan dalam file template untuk OnSuccess konfigurasi.

YAML

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