SNS

Objek yang menggambarkan tipe sumber peristiwa SNS.

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

Sintaks

Untuk mendeklarasikan entitas ini di templat 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

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

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

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

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

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

Region

Untuk langganan lintas wilayah, wilayah tempat topik berada.

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

Tipe: String

Wajib: Tidak

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

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

Kompatibilitas AWS CloudFormation: Properti ini unik bagi AWS SAM dan tidak memiliki padananAWS CloudFormation.

Topic

ARN dari topik untuk dilanggan.

Tipe: String

Wajib: Ya

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

Contoh-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