Tutorial: invio di una SNS notifica Amazon

Crea un SNS argomento Amazon.

1. Accedi alla SNSconsole Amazon.

2. Nel pannello di navigazione a sinistra, selezionare Topics (Argomenti).

3. Nella pagina Topics (Argomenti), seleziona Create topic (Crea argomento).

4. In Details (Dettagli), scegli il tipo standard. Per impostazione predefinita, la console crea un FIFO argomento.

5. In Nome, inserisci il nome dell'SNSargomento. Per questo tutorial, digita high_temp_notice.

6. Scorri fino alla parte inferiore della pagina e scegli Crea argomento.

   La console apre la pagina Details (Dettagli) del nuovo argomento.

Crea un SNS abbonamento Amazon.

1. Nella pagina dei dettagli dell'argomento high_temp_notice, scegli Create subscription (Crea sottoscrizione).

2. In Crea abbonamento, nella sezione Dettagli, nell'elenco Protocolli, scegli SMS.

3. In Endpoint, inserisci il numero di un telefono che può ricevere messaggi di testo. Assicurati di inserirlo in modo che inizi con un +, includa il paese e il prefisso locale e non includa altri caratteri di punteggiatura.

4. Scegli Crea sottoscrizione.

Prova la SNS notifica Amazon.

1. Nella SNSconsole Amazon, nel riquadro di navigazione a sinistra, scegli Argomenti.

2. Per aprire la pagina dei dettagli dell'argomento, in Topics (Argomenti), nell'elenco degli argomenti, seleziona high_temp_notice.

3. Per aprire la pagina Publish message to topic (Pubblica il messaggio nell'argomento), nella pagina dei dettagli high_temp_notice, scegli Publish message (Pubblica messaggio).

4. In Publish message to topic (Pubblica il messaggio nell'argomento), nella sezione Message body (Corpo del messaggio), in Message body to send to the endpoint (Corpo del messaggio da inviare all'endpoint), inserisci un breve messaggio.

5. Scorri fino alla parte inferiore della pagina e scegli Publish message (Pubblica messaggio).

6. Sul telefono con il numero che hai usato in precedenza durante la creazione della sottoscrizione, conferma che il messaggio è stato ricevuto.

Se non hai ricevuto il messaggio di prova, controlla due volte il numero di telefono e le impostazioni del tuo cellulare.

Assicurati di poter pubblicare messaggi di prova dalla SNSconsole Amazon prima di continuare il tutorial.

Apri l'hub Rules della AWS IoT console.

Se è la prima regola, scegli Create (Crea) oppure Create a rule (Crea una regola).

In Create a rule (Crea una regola):

1. In Nome, inserisci temp_limit_notify.

   Ricorda che il nome di una regola deve essere univoco all'interno della tua regione Account AWS e non può avere spazi. Abbiamo usato un carattere di sottolineatura in questo nome per separare le parole nel nome della regola.

2. In Description (Descrizione), descrivi la regola.

   Una descrizione significativa ti aiuta a ricordare cosa fa questa regola e perché l'hai creata. La descrizione può essere lunga quanto necessario, quindi sii il più dettagliato possibile.

In Rule query statement (Istruzione query regola) di Create a rule (Crea una regola):

1. In Utilizzo della SQL versione, seleziona 2016-03-23.

2. Nella casella di modifica Rule query statement (Istruzione query regola), inserisci l'istruzione:

   SELECT topic(2) as device_id, 
       temperature as reported_temperature, 
       30 as max_temperature 
     FROM 'device/+/data' 
     WHERE temperature > 30

   Questa istruzione:

   • Ascolta i MQTT messaggi con un argomento che corrisponde al filtro degli device/+/data argomenti e che hanno un temperature valore maggiore di 30.

   • Seleziona il secondo elemento dalla stringa dell'argomento e lo assegna al campo device_id.

   • Seleziona il valore del campo temperature dal payload del messaggio e lo assegna al campo reported_temperature.

   • Crea un valore costante 30 per rappresentare il valore limite e lo assegna al campo max_temperature.

Per aprire l'elenco delle azioni della regola per questa regola, in Set one or more actions (Imposta una o più azioni), scegli Add action (Aggiungi operazione).

In Seleziona un'azione, scegli Invia un messaggio come notifica SNS push.

Per aprire la pagina di configurazione dell'operazione selezionata, nella parte inferiore dell'elenco delle operazioni, scegli Configure action (Configura operazione).

In Configure action (Configura operazione):

1. In SNStarget, scegli Seleziona, trova l'SNSargomento denominato high_temp_notice e scegli Seleziona.

2. In Formato messaggio, scegli. RAW

3. In Scegli o crea un ruolo a cui concedere AWS IoT l'accesso per eseguire questa azione, scegli Crea ruolo.

4. In Create a new role (Crea un nuovo ruolo), in Name (Nome), inserisci un nome univoco per il nuovo ruolo. Ai fini di questo tutorial, utilizza sns_rule_role.

5. Scegliere Crea ruolo.

Se si ripete questo tutorial o si riutilizza un ruolo esistente, scegli Update role (Aggiorna ruolo) prima di continuare. Ciò aggiorna il documento politico del ruolo in modo che funzioni con l'SNSobiettivo.

Scegli Add action (Aggiungi operazione) e torna alla pagina Create a rule (Crea una regola).

Nel riquadro della nuova azione, sotto Invia un messaggio come notifica SNS push, puoi vedere l'SNSargomento che verrà richiamato dalla tua regola.

Questa è l'unica operazione della regola che aggiungerai a questa regola.

Per creare la regola e completare questo passaggio, in Create a rule (Crea una regola), scorri verso il basso e scegli Create a rule (Crea una regola).

Nel MQTT client della AWS IoT console, iscriviti agli argomenti di input, in questo caso,device/+/data.

1. Nel MQTT client, in Abbonamenti, scegli Sottoscrivi a un argomento.

2. In Subscription topic (Argomento sottoscrizione), inserisci l'argomento del filtro dell’argomento di input, device/+/data.

3. Lascia gli altri campi ai valori predefiniti.

4. Scegli Subscribe to topic (Effettua sottoscrizione all'argomento).

   Nella colonna Subscriptions (Sottoscrizioni), sotto Publish to a topic (Pubblica un argomento), device/+/data viene visualizzato.

Pubblicazione di un messaggio nell'argomento di input con un ID dispositivo specifico, device/32/data. Non puoi pubblicare MQTT su argomenti che contengono caratteri jolly.

1. Nel MQTT client, in Abbonamenti, scegli Pubblica su argomento.

2. Nel campo Publish (Pubblica), inserisci il nome dell'argomento di input, device/32/data.

3. Copia i dati di esempio mostrati qui e, nella casella di modifica sotto il nome dell'argomento, incolla i dati di esempio.

   {
     "temperature": 38,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

4. Scegli Pubblica su argomento per pubblicare il tuo MQTT messaggio.

Conferma che il messaggio di testo è stato inviato.

1. Nel MQTT client, sotto Abbonamenti, c'è un punto verde accanto all'argomento a cui ti sei iscritto in precedenza.

   I punti verdi indicano che uno o più nuovi messaggi sono stati ricevuti dall'ultima volta che li hai visualizzati.

2. Sotto Subscriptions (Sottoscrizioni), scegli device/+/data (dispositivo/+/dati) per verificare che il payload del messaggio corrisponda a quello che hai appena pubblicato e assomigli a questo:

   {
     "temperature": 38,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

3. Controlla che il telefono che hai usato per iscriverti all'SNSargomento e conferma che il contenuto del payload del messaggio abbia questo aspetto:

   {"device_id":"32","reported_temperature":38,"max_temperature":30}

   Nota che il valore device_id è una stringa tra virgolette e il valore temperature è numerico. Questo perché la funzione topic() ha estratto la stringa dal nome dell'argomento del messaggio di input mentre il valore temperature utilizza il valore numerico dal payload del messaggio di input.

   Se desideri rendere il valore device_id un valore numerico, sostituisci topic(2) nell'istruzione query della regola con:

   cast(topic(2) AS DECIMAL)

   Nota che la trasformazione del valore topic(2) in un valore numerico DECIMAL funzionerà solo se quella parte dell'argomento contiene solo caratteri numerici.

Prova a inviare un MQTT messaggio in cui la temperatura non superi il limite.

1. Nel MQTT client, in Abbonamenti, scegli Pubblica su argomento.

2. Nel campo Publish (Pubblica), inserisci il nome dell'argomento di input, device/33/data.

3. Copia i dati di esempio mostrati qui e, nella casella di modifica sotto il nome dell'argomento, incolla i dati di esempio.

   {
     "temperature": 28,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

4. Per inviare il MQTT messaggio, scegli Pubblica su argomento.

Dovrebbe essere visualizzato il messaggio inviato nella sottoscrizione device/+/data. Tuttavia, poiché il valore della temperatura è inferiore alla temperatura massima nell'istruzione di query della regola, non si dovrebbe ricevere un messaggio di testo.

Se il comportamento non viene visualizzato correttamente, controlla i suggerimenti per la risoluzione dei problemi.