SNS

Das Objekt, das einen SNS Ereignisquellentyp beschreibt.

SAM generiert eine AWS::SNS::SubscriptionRessource, wenn dieser Ereignistyp festgelegt ist

Syntax

Verwenden Sie die folgende Syntax, um diese Entität in Ihrer Vorlage AWS Serverless Application Model (AWS SAM) zu deklarieren.

YAML

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

Eigenschaften

FilterPolicy

Das Filterrichtlinien-JSON, das dem Abonnement zugeordnet ist. Weitere Informationen finden Sie GetSubscriptionAttributesin der Amazon Simple Notification Service API-Referenz.

Typ: SnsFilterPolicy

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die FilterPolicy Eigenschaft einer AWS::SNS::Subscription Ressource übergeben.

FilterPolicyScope

Mit diesem Attribut können Sie den Filterbereich mithilfe eines der folgenden Zeichenfolgenwerttypen auswählen:

• MessageAttributes— Der Filter wird auf die Nachrichtenattribute angewendet.

• MessageBody— Der Filter wird auf den Nachrichtentext angewendet.

Typ: Zeichenfolge

Required: No

Standardwert: MessageAttributes

AWS CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die FilterPolicyScope Eigenschaft einer AWS::SNS::Subscription Ressource übergeben.

RedrivePolicy

Wenn angegeben, werden unzustellbare Nachrichten an die angegebene Amazon SQS-Warteschlange für unzustellbare Nachrichten gesendet. Nachrichten, die aufgrund von Clientfehlern (z. B. wenn der abonnierte Endpunkt nicht erreichbar ist) oder Serverfehlern (z. B. wenn der Service, der den abonnierten Endpunkt betreibt, nicht verfügbar ist) nicht zugestellt werden können, werden in der Warteschlange für unzustellbare Nachrichten zur weiteren Analyse oder erneuten Verarbeitung gespeichert.

Weitere Informationen zur Redrive-Richtlinie und zu Warteschlangen für unzustellbare Briefe finden Sie unter Amazon SQS Dead-Letter-Warteschlangen im Amazon Simple Queue Service Developer Guide.

Type: Json

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die Eigenschaft einer Ressource übergeben. RedrivePolicy AWS::SNS::Subscription

Region

Für regionsübergreifende Abonnements, die Region, in der das Thema gespeichert ist.

Wenn keine Region angegeben ist, wird standardmäßig die Region des Anrufers CloudFormation verwendet.

Typ: Zeichenfolge

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die Region Eigenschaft einer AWS::SNS::Subscription Ressource übergeben.

SqsSubscription

Setzen Sie diese Eigenschaft auf „true“ oder geben Sie SqsSubscriptionObject an, dass SNS-Themenbenachrichtigungen in einer SQS-Warteschlange gebündelt werden sollen. Wenn Sie diese Eigenschaft auf festlegen, true wird eine neue SQS-Warteschlange erstellt, wohingegen die Angabe von a eine vorhandene SQS-Warteschlange SqsSubscriptionObject verwendet.

Typ: Boolean | SqsSubscriptionObject

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein AWS CloudFormation Äquivalent.

Topic

Der ARN des zu abonnierenden Themas.

Typ: Zeichenfolge

Erforderlich: Ja

AWS CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die TopicArn Eigenschaft einer AWS::SNS::Subscription Ressource übergeben.

Beispiele

Beispiel für eine SNS-Ereignisquelle

Beispiel für eine SNS-Ereignisquelle

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