Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

L'oggetto che descrive un tipo di origine `SNS` dell'evento.

SAM genera [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)una risorsa quando viene impostato questo tipo di evento

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

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

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

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

 `FilterPolicy`   <a name="sam-function-sns-filterpolicy"></a>
Il codice JSON della policy di filtro assegnato alla sottoscrizione. Per ulteriori informazioni, consulta [GetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)Amazon Simple Notification Service API Reference.  
*Tipo:* [SnsFilterPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicy)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[FilterPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicy)` proprietà di una `AWS::SNS::Subscription` risorsa.

 `FilterPolicyScope`   <a name="sam-function-sns-filterpolicyscope"></a>
Questo attributo consente di scegliere l'ambito di filtraggio utilizzando uno dei seguenti tipi di valori di stringa:  
+ `MessageAttributes`— Il filtro viene applicato agli attributi del messaggio.
+ `MessageBody`— Il filtro viene applicato al corpo del messaggio.
▬*Tipo:* stringa  
*Obbligatorio:* no  
*Default*: `MessageAttributes`  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla ` [ FilterPolicyScope](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicyscope)` proprietà di una `AWS::SNS::Subscription` risorsa.

 `RedrivePolicy`   <a name="sam-function-sns-redrivepolicy"></a>
Quando è specificato, invia i messaggi non recapitabili alla coda DLQ di Amazon SQS specificata. I messaggi che non possono essere recapitati a causa di errori client (ad esempio, quando l'endpoint sottoscritto non è raggiungibile) o errori del server (ad esempio, quando il servizio che alimenta l'endpoint sottoscritto diventa non disponibile) vengono mantenuti nella coda DLQ per ulteriori analisi o elaborazione.  
*Per ulteriori informazioni sulla politica di redrive e sulle code di lettera morta di Amazon SQS, consulta la pagina Amazon SQS Dead-letter [queues nella Amazon Simple Queue Service](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html) Developer Guide.*  
*Type*: Json  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla proprietà di una risorsa. `[ 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>
Per le sottoscrizioni in più Regioni, la Regione in cui si trova l'argomento.  
Se non viene specificata alcuna regione, CloudFormation utilizza la regione del chiamante come impostazione predefinita.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Region](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-region)` proprietà di una `AWS::SNS::Subscription` risorsa.

 `SqsSubscription`   <a name="sam-function-sns-sqssubscription"></a>
Imposta questa proprietà su true o specifica di `SqsSubscriptionObject` abilitare l'invio in batch delle notifiche degli argomenti SNS in una coda SQS. L'impostazione di questa proprietà per `true` creare una nuova coda SQS, mentre se si specifica a si utilizza una coda SQS esistente. `SqsSubscriptionObject`  
*Tipo: Boolean \$1 [SqsSubscriptionObject](sam-property-function-sqssubscriptionobject.md)*  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Topic`   <a name="sam-function-sns-topic"></a>
L'ARN dell'argomento a cui effettuare la sottoscrizione  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[TopicArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#topicarn)` proprietà di una `AWS::SNS::Subscription` risorsa.

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

### Esempio di origine degli eventi SNS
<a name="sam-property-function-sns--examples--sns-event-source-example"></a>

Esempio di origine di eventi SNS

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

Specificate un'opzione di coda SQS esistente per l'evento SNS

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

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

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

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

 `BatchSize`   <a name="sam-function-sqssubscriptionobject-batchsize"></a>
Il numero massimo di elementi da recuperare in un singolo batch per la coda SQS.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*Impostazione predefinita*: 10  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

 `Enabled`   <a name="sam-function-sqssubscriptionobject-enabled"></a>
Disattiva la mappatura delle sorgenti degli eventi SQS per sospendere il polling e la chiamata.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*Impostazione* predefinita: True  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `QueueArn`   <a name="sam-function-sqssubscriptionobject-queuearn"></a>
Specificare un arn di coda SQS esistente.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

 `QueuePolicyLogicalId`   <a name="sam-function-sqssubscriptionobject-queuepolicylogicalid"></a>
Assegna un nome LogicalID personalizzato per la [AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html)risorsa.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `QueueUrl`   <a name="sam-function-sqssubscriptionobject-queueurl"></a>
Specificare l'URL della coda associato alla `QueueArn` proprietà.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

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

### Evento SQS for SNS esistente
<a name="sam-property-function-sqssubscriptionobject--examples--existing-sqs-for-sns-event"></a>

Esempio di aggiunta di una coda SQS esistente per l'iscrizione a un argomento SNS.

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