Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# SNS
<a name="sam-property-function-sns"></a>

Das Objekt, das einen `SNS` Ereignisquellentyp beschreibt.

SAM generiert eine [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html)Ressource, wenn dieser Ereignistyp festgelegt ist

## Syntax
<a name="sam-property-function-sns-syntax"></a>

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

### YAML
<a name="sam-property-function-sns-syntax.yaml"></a>

```
  [FilterPolicy](#sam-function-sns-filterpolicy): {{[SnsFilterPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicy)}}
  FilterPolicyScope: {{String}}
  RedrivePolicy: {{Json}}
  [Region](#sam-function-sns-region): {{String}}
  [SqsSubscription](#sam-function-sns-sqssubscription): {{Boolean | SqsSubscriptionObject}}
  [Topic](#sam-function-sns-topic): {{String}}
```

## Eigenschaften
<a name="sam-property-function-sns-properties"></a>

 `FilterPolicy`   <a name="sam-function-sns-filterpolicy"></a>
Das Filterrichtlinien-JSON, das dem Abonnement zugeordnet ist. Weitere Informationen finden Sie [GetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)in der Amazon Simple Notification Service API-Referenz.  
*Typ:* [SnsFilterPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicy)  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[FilterPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicy)` Eigenschaft einer `AWS::SNS::Subscription` Ressource übergeben.

 `FilterPolicyScope`   <a name="sam-function-sns-filterpolicyscope"></a>
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`  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die ` [ FilterPolicyScope](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicyscope)` Eigenschaft einer `AWS::SNS::Subscription` Ressource übergeben.

 `RedrivePolicy`   <a name="sam-function-sns-redrivepolicy"></a>
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](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html) Queue Service Developer Guide.*  
*Type*: Json  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die Eigenschaft einer Ressource übergeben. `[ RedrivePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-redrivepolicy)` `AWS::SNS::Subscription`

 `Region`   <a name="sam-function-sns-region"></a>
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  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[Region](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-region)` Eigenschaft einer `AWS::SNS::Subscription` Ressource übergeben.

 `SqsSubscription`   <a name="sam-function-sns-sqssubscription"></a>
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](sam-property-function-sqssubscriptionobject.md)  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `Topic`   <a name="sam-function-sns-topic"></a>
Der ARN des zu abonnierenden Themas.  
*Typ:* Zeichenfolge  
*Erforderlich*: Ja  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[TopicArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#topicarn)` Eigenschaft einer `AWS::SNS::Subscription` Ressource übergeben.

## Beispiele
<a name="sam-property-function-sns--examples"></a>

### Beispiel für eine SNS-Ereignisquelle
<a name="sam-property-function-sns--examples--sns-event-source-example"></a>

Beispiel für eine SNS-Ereignisquelle

#### YAML
<a name="sam-property-function-sns--examples--sns-event-source-example--yaml"></a>

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