SNS

Objek yang menggambarkan tipe sumber peristiwa SNS.

SAM menghasilkan AWS::SNS::Subscriptionsumber daya saat jenis acara ini disetel

Sintaks

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

YAML

  FilterPolicy: SnsFilterPolicy
  FilterPolicyScope: String
  RedrivePolicy: Json
  Region: String
  SqsSubscription: Boolean | SqsSubscriptionObject
  Topic: String

Properti

FilterPolicy

Kebijakan filter JSON yang ditetapkan untuk langganan. Untuk informasi selengkapnya, lihat GetSubscriptionAttributesdi Referensi API Layanan Pemberitahuan Sederhana Amazon.

Jenis: SnsFilterPolicy

Wajib: Tidak

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke FilterPolicy properti AWS::SNS::Subscription sumber daya.

FilterPolicyScope

Atribut ini memungkinkan Anda memilih lingkup penyaringan dengan menggunakan salah satu jenis nilai string berikut:

• MessageAttributes— Filter diterapkan pada atribut pesan.

• MessageBody— Filter diterapkan pada badan pesan.

Tipe: String

Wajib: Tidak

Default: MessageAttributes

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke FilterPolicyScope properti AWS::SNS::Subscription sumber daya.

RedrivePolicy

Bila ditentukan, kirim pesan yang tidak terkirim ke antrean surat mati Amazon SQS yang ditentukan. Pesan yang tidak dapat dikirim karena kesalahan klien (misalnya, ketika titik akhir berlangganan tidak terjangkau) atau kesalahan server (misalnya, ketika layanan yang mendorong titik akhir langganan menjadi tidak tersedia) diadakan di antrean surat mati untuk analisis lebih lanjut atau pemrosesan ulang.

Untuk informasi selengkapnya tentang kebijakan redrive dan antrian surat mati, lihat antrian surat mati Amazon SQS di Panduan Pengembang Layanan Antrian Sederhana Amazon.

Jenis: Json

Wajib: Tidak

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke RedrivePolicy properti AWS::SNS::Subscription sumber daya.

Region

Untuk langganan lintas region, region tempat topik berada.

Jika tidak ada wilayah yang ditentukan, CloudFormation gunakan wilayah pemanggil sebagai default.

Tipe: String

Wajib: Tidak

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke Region properti AWS::SNS::Subscription sumber daya.

SqsSubscription

Atur properti ini menjadi BETUL, atau tentukan SqsSubscriptionObject untuk mengaktifkan batching notifikasi topik SNS dalam antrean SQS. Mengatur properti ini menjadi true membuat antrean SQS baru, sedangkan menentukan SqsSubscriptionObject menggunakan antrean SQS yang ada.

Jenis: Boolean | SqsSubscriptionObject

Wajib: Tidak

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

Topic

ARN dari topik untuk dilanggan.

Tipe: String

Wajib: Ya

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke TopicArn properti AWS::SNS::Subscription sumber daya.

Contoh

Contoh Sumber Peristiwa SNS

Contoh Sumber Peristiwa SNS

YAML

Events:
  SNSEvent:
    Type: SNS
    Properties:
      Topic: arn:aws:sns:us-east-1:123456789012:my_topic
      SqsSubscription: true
      FilterPolicy:
        store:
          - example_corp
        price_usd:
          - numeric:
              - ">="
              - 100