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* \$1 [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
```

# SqsSubscriptionObject
<a name="sam-property-function-sqssubscriptionobject"></a>

Geben Sie eine bestehende SQS-Warteschlangenoption für das SNS-Ereignis an

## Syntax
<a name="sam-property-function-sqssubscriptionobject-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-sqssubscriptionobject-syntax.yaml"></a>

```
  [BatchSize](#sam-function-sqssubscriptionobject-batchsize): String
  [Enabled](#sam-function-sqssubscriptionobject-enabled): Boolean
  [QueueArn](#sam-function-sqssubscriptionobject-queuearn): String
  [QueuePolicyLogicalId](#sam-function-sqssubscriptionobject-queuepolicylogicalid): String
  [QueueUrl](#sam-function-sqssubscriptionobject-queueurl): String
```

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

 `BatchSize`   <a name="sam-function-sqssubscriptionobject-batchsize"></a>
Die maximale Anzahl von Elementen, die in einem einzigen Batch für die SQS-Warteschlange abgerufen werden können.  
*Typ:* Zeichenfolge  
*Required*: No  
*Standard*: 10  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `Enabled`   <a name="sam-function-sqssubscriptionobject-enabled"></a>
Deaktiviert die Zuordnung der SQS-Ereignisquellen, um die Abfrage und den Aufruf zu unterbrechen.  
*Typ*: Boolesch  
*Required*: No  
*Standard: Wahr*  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `QueueArn`   <a name="sam-function-sqssubscriptionobject-queuearn"></a>
Geben Sie einen vorhandenen SQS-Warteschlangen-ARN an.  
*Typ:* Zeichenfolge  
*Erforderlich*: Ja  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `QueuePolicyLogicalId`   <a name="sam-function-sqssubscriptionobject-queuepolicylogicalid"></a>
Geben Sie einen benutzerdefinierten LogicalID-Namen für die Ressource ein. [AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html)  
*Typ:* Zeichenfolge  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein Äquivalent. CloudFormation 

 `QueueUrl`   <a name="sam-function-sqssubscriptionobject-queueurl"></a>
Geben Sie die Warteschlangen-URL an, die der `QueueArn` Eigenschaft zugeordnet ist.  
*Typ:* Zeichenfolge  
*Erforderlich*: Ja  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

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

### Existierendes Ereignis SQS für SNS
<a name="sam-property-function-sqssubscriptionobject--examples--existing-sqs-for-sns-event"></a>

Beispiel für das Hinzufügen einer vorhandenen SQS-Warteschlange zum Abonnieren eines SNS-Themas.

#### YAML
<a name="sam-property-function-sqssubscriptionobject--examples--existing-sqs-for-sns-event--yaml"></a>

```
QueuePolicyLogicalId: CustomQueuePolicyLogicalId
QueueArn:
  Fn::GetAtt: MyCustomQueue.Arn
QueueUrl:
  Ref: MyCustomQueue
BatchSize: 5
```