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à.

# Amazon SNS
<a name="sns-component"></a>

Il componente Amazon SNS (`aws.greengrass.SNS`) pubblica messaggi su un argomento Amazon Simple Notification Service (Amazon SNS). Puoi utilizzare questo componente per inviare eventi dai dispositivi principali di Greengrass a server Web, indirizzi e-mail e altri abbonati ai messaggi. Per ulteriori informazioni, consulta [ Cos'è Amazon SNS? ](https://docs.aws.amazon.com/sns/latest/dg/welcome.html)nella * Amazon Simple Notification Service Developer Guide*.

Per pubblicare su un argomento Amazon SNS con questo componente, pubblica un messaggio sull'argomento a cui questo componente è abbonato. Per impostazione predefinita, questo componente si iscrive all'`sns/message`[argomento locale. publish/subscribe ](ipc-publish-subscribe.md) È possibile specificare altri argomenti, inclusi gli argomenti AWS IoT Core MQTT, quando si distribuisce questo componente.

Nel componente personalizzato, potresti voler implementare una logica di filtraggio o formattazione per elaborare i messaggi provenienti da altre fonti prima di pubblicarli su questo componente. Ciò consente di centralizzare la logica di elaborazione dei messaggi su un singolo componente.

**Nota**  
Questo componente fornisce funzionalità simili al connettore Amazon SNS nella AWS IoT Greengrass V1. Per ulteriori informazioni, consulta il connettore [ Amazon SNS ](https://docs.aws.amazon.com/greengrass/latest/developerguide/sns-connector.html) nella *AWS IoT Greengrass V1 Developer Guide. *

**Topics**
+ [Versioni](#sns-component-versions)
+ [Tipo](#sns-component-type)
+ [Sistema operativo](#sns-component-os-support)
+ [Requisiti](#sns-component-requirements)
+ [Dipendenze](#sns-component-dependencies)
+ [Configurazione](#sns-component-configuration)
+ [Dati di input](#sns-component-input-data)
+ [Dati di output](#sns-component-output-data)
+ [File di registro locale](#sns-component-log-file)
+ [Licenze](#sns-component-licenses)
+ [Changelog](#sns-component-changelog)

## Versioni
<a name="sns-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.1.x
+ 2.0.x

## Tipo
<a name="sns-component-type"></a>

<a name="public-component-type-lambda"></a>Questo <a name="public-component-type-lambda-phrase"></a> componente è un componente Lambda (`aws.greengrass.lambda`). Il nucleo di [ Greengrass ](greengrass-nucleus-component.md) esegue la funzione Lambda di questo componente utilizzando il componente di avvio [ Lambda. ](lambda-launcher-component.md) 

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="sns-component-os-support"></a>

Questo componente può essere installato solo su dispositivi Linux core.

## Requisiti
<a name="sns-component-requirements"></a>

Questo componente ha i seguenti requisiti:
+ <a name="core-device-lambda-function-requirements"></a>Il dispositivo principale deve soddisfare i requisiti per eseguire le funzioni Lambda. Se desideri che il dispositivo principale esegua funzioni Lambda containerizzate, il dispositivo deve soddisfare i requisiti per farlo. Per ulteriori informazioni, consulta [Requisiti della funzione Lambda](setting-up.md#greengrass-v2-lambda-requirements).
+ <a name="public-component-python3-requirement"></a>[La ](https://www.python.org/) versione 3.7 di Python è stata installata sul dispositivo principale e aggiunta alla variabile di ambiente PATH.
+ Argomento Amazon SNS Per le istruzioni, consulta [Creazione di un argomento Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) nella *Guida per lo Sviluppatore di Amazon Simple Notification Service*.
+ Il ruolo del dispositivo [ Greengrass ](device-service-role.md) deve consentire l'`sns:Publish`azione, come mostrato nel seguente esempio di policy IAM.

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "sns:Publish"
        ],
        "Effect": "Allow",
        "Resource": [
          "arn:aws:sns:{{us-east-1}}:{{123456789012}}:{{topic-name}}"
        ]
      }
    ]
  }
  ```

------

  È possibile sovrascrivere dinamicamente l'argomento predefinito nel payload del messaggio di input per questo componente. Se l'applicazione utilizza questa funzionalità, la policy IAM deve includere tutti gli argomenti di destinazione come risorse. Puoi concedere alle risorse un accesso granulare o condizionale (ad esempio, utilizzando uno schema di denominazione con il carattere jolly `*`).
+ <a name="connector-component-legacy-subscription-router-dependency"></a>Per ricevere i dati di output da questo componente, è necessario unire il seguente aggiornamento di configurazione per il [ vecchio componente del router in abbonamento ](legacy-subscription-router-component.md) (`aws.greengrass.LegacySubscriptionRouter`) quando si distribuisce questo componente. Questa configurazione specifica l'argomento in cui questo componente pubblica le risposte.

------
#### [ Legacy subscription router v2.1.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-sns": {
        "id": "aws-greengrass-sns",
        "source": "component:aws.greengrass.SNS",
        "subject": "sns/message/status",
        "target": "cloud"
      }
    }
  }
  ```

------
#### [ Legacy subscription router v2.0.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-sns": {
        "id": "aws-greengrass-sns",
        "source": "arn:aws:lambda:{{region}}:aws:function:aws-greengrass-sns:{{version}}",
        "subject": "sns/message/status",
        "target": "cloud"
      }
    }
  }
  ```<a name="connector-component-legacy-subscription-router-dependency-replace"></a>
  + Sostituisci {{region}} con quello Regione AWS che usi.
  + Sostituisci {{version}} con la versione della funzione Lambda eseguita da questo componente. Per trovare la versione della funzione Lambda, è necessario visualizzare la ricetta per la versione di questo componente che si desidera distribuire. Apri la pagina dei dettagli di questo componente nella [AWS IoT Greengrass console e cerca la ](https://console.aws.amazon.com/greengrass) coppia chiave-valore della funzione ** ** Lambda. Questa coppia chiave-valore contiene il nome e la versione della funzione Lambda.

**Importante**  <a name="connector-component-legacy-subscription-router-dependency-note"></a>
È necessario aggiornare la versione della funzione Lambda sul router di abbonamento precedente ogni volta che si distribuisce questo componente. Ciò garantisce l'utilizzo della versione della funzione Lambda corretta per la versione del componente da distribuire.

------

  <a name="connector-component-create-deployments"></a>Per ulteriori informazioni, consulta [Creare distribuzione](create-deployments.md).
+ Il componente Amazon SNS è supportato per l'esecuzione in un VPC. Per distribuire questo componente in un VPC, è necessario quanto segue.
  + Il componente Amazon SNS deve avere una connettività a `sns.region.amazonaws.com` cui l'endpoint VPC è di. `com.amazonaws.us-east-1.sns`

### Endpoint e porte
<a name="sns-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita ai seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per il funzionamento di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
| `sns.{{region}}.amazonaws.com` | 443 | Sì | Pubblicare i messaggi su Amazon SNS. | 

## Dipendenze
<a name="sns-component-dependencies"></a>

Quando si distribuisce un componente, vengono distribuite AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti del componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni [ rilasciate ](#sns-component-changelog) di questo componente e i vincoli semantici della versione che definiscono le versioni dei componenti per ciascuna dipendenza. È inoltre possibile visualizzare le dipendenze per ciascuna versione del componente nella console. [AWS IoT Greengrass](https://console.aws.amazon.com/greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle ** dipendenze**.

------
#### [ 2.1.10 ]

La tabella seguente elenca le dipendenze per la versione 2.1.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.16.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.9 ]

La tabella seguente elenca le dipendenze per la versione 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.15.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.8 ]

La tabella seguente elenca le dipendenze per la versione 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.14.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.7 ]

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.13.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.6 ]

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.12.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.5 ]

La tabella seguente elenca le dipendenze per la versione 2.1.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.11.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.4 ]

La tabella seguente elenca le dipendenze per la versione 2.1.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.10.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.3 ]

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.9.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.2 ]

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.8.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.7.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.8 - 2.1.0 ]

La tabella seguente elenca le dipendenze per le versioni 2.0.8 e 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.6.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.7 ]

La tabella seguente elenca le dipendenze per la versione 2.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.5.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.6 ]

La tabella seguente elenca le dipendenze per la versione 2.0.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.4.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.5 ]

La tabella seguente elenca le dipendenze per la versione 2.0.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.3.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.4 ]

La tabella seguente elenca le dipendenze per la versione 2.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.2.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.3 ]

La tabella seguente elenca le dipendenze per la versione 2.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.3 <2.1.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | > = 1.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | > = 1.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | >=1.0.0  | Rigidi | 

------

Per ulteriori informazioni sulle dipendenze dei componenti, consultate il riferimento alla composizione dei componenti. [ComponentDependencies](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="sns-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

**Nota**  <a name="connector-component-lambda-parameters"></a>
La configurazione predefinita di questo componente include i parametri della funzione Lambda. Ti consigliamo di modificare solo i seguenti parametri per configurare questo componente sui tuoi dispositivi.

`lambdaParams`  
Un oggetto che contiene i parametri per la funzione Lambda di questo componente. Questo oggetto contiene le seguenti informazioni:    
`EnvironmentVariables`  
Un oggetto che contiene i parametri della funzione Lambda. Questo oggetto contiene le seguenti informazioni:    
`DEFAULT_SNS_ARN`  
L'ARN dell'argomento predefinito di Amazon SNS in cui questo componente pubblica messaggi. Puoi sovrascrivere l'argomento di destinazione con la `sns_topic_arn` proprietà nel payload del messaggio di input.

`containerMode`  <a name="connector-component-container-mode-parameter"></a>
(Facoltativo) La modalità di containerizzazione per questo componente. Seleziona una delle opzioni seguenti:  <a name="lambda-function-component-container-mode-parameter"></a>
+ `NoContainer`— Il componente non viene eseguito in un ambiente di runtime isolato.
+ `GreengrassContainer`— Il componente viene eseguito in un ambiente di runtime isolato all'interno del AWS IoT Greengrass contenitore.
Impostazione predefinita: `GreengrassContainer`

`containerParams`  
<a name="connector-component-container-params-description"></a>(Facoltativo) Un oggetto che contiene i parametri del contenitore per questo componente. Il componente utilizza questi parametri se specificate `GreengrassContainer` per`containerMode`.  
Questo oggetto contiene le seguenti informazioni:    
`memorySize`  
<a name="connector-component-container-params-memory-size-description"></a>(Facoltativo) La quantità di memoria (in kilobyte) da allocare al componente.  
Il valore predefinito è 512 MB (525.312 KB).

`pubsubTopics`  <a name="connector-component-pubsub-topics-parameter"></a>
(Facoltativo) Un oggetto che contiene gli argomenti a cui il componente si iscrive per ricevere messaggi. È possibile specificare ogni argomento e se il componente sottoscrive argomenti MQTT provenienti da AWS IoT Core o argomenti locali. publish/subscribe   
Questo oggetto contiene le seguenti informazioni:    
`0`— Questo è un indice di matrice sotto forma di stringa.  
Un oggetto che contiene le seguenti informazioni:    
`type`  
(Facoltativo) Il tipo di publish/subscribe messaggistica utilizzato da questo componente per sottoscrivere i messaggi. Seleziona una delle opzioni seguenti:  
+ `PUB_SUB`— Sottoscrivi ai publish/subscribe messaggi locali. Se scegli questa opzione, l'argomento non può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi da un componente personalizzato quando si specifica questa opzione, vedere. [Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md)
+ `IOT_CORE`— Iscriviti ai messaggi AWS IoT Core MQTT. Se scegli questa opzione, l'argomento può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi da componenti personalizzati quando si specifica questa opzione, vedere. [Publish/subscribe AWS IoT Core Messaggi MQTT](ipc-iot-core-mqtt.md)
Impostazione predefinita: `PUB_SUB`  
`topic`  
(Facoltativo) L'argomento a cui il componente si iscrive per ricevere messaggi. Se si specifica `IotCore` per`type`, è possibile utilizzare i caratteri jolly MQTT (`+`e`#`) in questo argomento.

**Example Esempio: aggiornamento dell'unione delle configurazioni (modalità contenitore)**  

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic"
    }
  },
  "containerMode": "GreengrassContainer"
}
```

**Example Esempio: aggiornamento dell'unione delle configurazioni (nessuna modalità contenitore)**  

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic"
    }
  },
  "containerMode": "NoContainer"
}
```

## Dati di input
<a name="sns-component-input-data"></a>

Questo componente accetta messaggi sull'argomento seguente e pubblica il messaggio così com'è nell'argomento Amazon SNS di destinazione. <a name="connector-component-local-publish"></a>Per impostazione predefinita, questo componente si iscrive ai messaggi locali. publish/subscribe Per ulteriori informazioni su come pubblicare messaggi su questo componente dai componenti personalizzati, vedere[Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md).  

**Argomento predefinito (locale publish/subscribe): ** `sns/message`

<a name="connector-component-input-properties"></a>Il messaggio accetta le seguenti proprietà. I messaggi di input devono essere in formato JSON.

`request`  
Le informazioni sul messaggio da inviare all'argomento Amazon SNS.  
Tipo: `object` che contiene le seguenti informazioni:    
`message`  
Il contenuto del messaggio sotto forma di stringa.  
Per inviare un oggetto JSON, serializzalo come stringa e specifica `json` la `message_structure` proprietà.  
Tipo: `string`  
`subject`  
(Facoltativo) L'oggetto del messaggio.  
Tipo: `string`  
L'oggetto può essere testo ASCII e contenere fino a 100 caratteri. Deve iniziare con una lettera, un numero o un segno di punteggiatura. Non può includere interruzioni di riga o caratteri di controllo.  
`sns_topic_arn`  
(Facoltativo) L'ARN dell'argomento Amazon SNS in cui questo componente pubblica il messaggio. Specifica questa proprietà per sovrascrivere l'argomento predefinito di Amazon SNS.  
Tipo: `string`  
`message_structure`  
(Facoltativo) La struttura del messaggio. Specifica `json` di inviare un messaggio JSON da serializzare come stringa nella `content` proprietà.  
Tipo: `string`  
Valori validi: `json`

`id`  <a name="connector-component-input-property-id"></a>
Un ID arbitrario della richiesta. Usa questa proprietà per mappare una richiesta di input a una risposta di output. Quando si specifica questa proprietà, il componente imposta la `id` proprietà nell'oggetto di risposta su questo valore.  
Tipo: `string`

**Nota**  
La dimensione del messaggio può essere un massimo di 256 KB.

**Example Input di esempio: messaggio in formato stringa**  

```
{
  "request": {
    "subject": "Message subject",
    "message": "Message data",
    "sns_topic_arn": "arn:aws:sns:{{region}}:{{account-id}}:topic2-name"
  },
  "id": "request123"
}
```

**Example Input di esempio: messaggio JSON**  

```
{
  "request": {
    "subject": "Message subject",
    "message": "{ \"default\": \"Message data\" }",
    "message_structure": "json"
  },
  "id": "request123"
}
```

## Dati di output
<a name="sns-component-output-data"></a>

 <a name="connector-component-output-data"></a>Per impostazione predefinita, questo componente pubblica le risposte come dati di output sul seguente argomento MQTT. È necessario specificare questo argomento come `subject` nella configurazione per il componente router in abbonamento [ legacy](legacy-subscription-router-component.md). Per ulteriori informazioni su come sottoscrivere i messaggi su questo argomento nei componenti personalizzati, vedere[Publish/subscribe AWS IoT Core Messaggi MQTT](ipc-iot-core-mqtt.md).  

**Argomento predefinito (AWS IoT Core MQTT): ** `sns/message/status`

**Example Output di esempio: Operazione riuscita**  

```
{
  "response": {
    "sns_message_id": "f80a81bc-f44c-56f2-a0f0-d5af6a727c8a",
    "status": "success"
  },
  "id": "request123"
}
```

**Example Esempio di output: Errore**  

```
{
  "response" : {
    "error": "InvalidInputException",
    "error_message": "SNS Topic Arn is invalid",
    "status": "fail"
  },
  "id": "request123"
}
```

## File di registro locale
<a name="sns-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

```
{{/greengrass/v2}}/logs/aws.greengrass.SNS.log
```

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituiscilo `{{/greengrass/v2}}` con il percorso della cartella AWS IoT Greengrass principale.

  ```
  sudo tail -f {{/greengrass/v2}}/logs/aws.greengrass.SNS.log
  ```

## Licenze
<a name="sns-component-licenses"></a>

Questo componente include le seguenti terze parti software/licensing:<a name="boto-3-licenses"></a>
+ [AWS SDK per Python (Boto3)](https://pypi.org/project/boto3/)/Apache License 2.0
+ [botocore](https://pypi.org/project/botocore/)/Apache License 2.0
+ [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF License
+ [docutils](https://pypi.org/project/docutils/)/BSD License, GNU General Public License (GPL), Python Software Foundation License, Public Domain
+ [jmespath](https://pypi.org/project/jmespath/)/MIT License
+ [s3transfer](https://pypi.org/project/s3transfer/)/Apache License 2.0
+ [urllib3](https://pypi.org/project/urllib3/)/MIT License

<a name="component-core-software-license"></a>Questo componente è rilasciato in base al contratto [ di licenza software ](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) Greengrass Core.

## Changelog
<a name="sns-component-changelog"></a>

La tabella seguente descrive le modifiche in ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
| 2.1.10 | Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. | 
| 2.1.9 | Versione aggiornata per la versione 2.14.0 di Greengrass nucleus. | 
| 2.1.8 | Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. | 
| 2.1.7 | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
| 2.1.6 | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
| 2.1.5 | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
| 2.1.4 | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
| 2.1.3 | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
| 2.1.2 | Versione aggiornata per la versione 2.7.0 di Greengrass nucleus. | 
| 2.1.1 | Versione aggiornata per la versione 2.6.0 di Greengrass nucleus. | 
| 2.1.0 |  **Nuove funzionalità**<br />   Aggiunge il supporto per le configurazioni del proxy di rete HTTPS. Per ulteriori informazioni, consulta [Connessione alla porta 443 o tramite un proxy di rete](configure-greengrass-core-v2.md#configure-alpn-network-proxy) e [Abilita il dispositivo principale in modo che consideri attendibile un proxy HTTPS](configure-greengrass-core-v2.md#https-proxy-certificate-trust).     | 
| 2.0.8 | Versione aggiornata per la versione 2.5.0 di Greengrass nucleus. | 
| 2.0.7 | Versione aggiornata per la versione 2.4.0 di Greengrass nucleus. | 
| 2.0.6 | Versione aggiornata per la versione 2.3.0 di Greengrass nucleus. | 
| 2.0.5 | Versione aggiornata per la versione 2.2.0 di Greengrass nucleus. | 
| 2.0.4 | Versione aggiornata per la versione 2.1.0 di Greengrass nucleus. | 
| 2.0.3 | Versione iniziale. |