Tutorial: Eine SNS Amazon-Benachrichtigung senden

Erstellen Sie ein SNS Amazon-Thema.

1. Melden Sie sich bei der SNSAmazon-Konsole an.

2. Wählen Sie im linken Navigationsbereich Topics (Themen).

3. Wählen Sie auf der Seite Topics (Themen) Create New Topic (Neues Thema erstellen) aus.

4. Wählen Sie unter Details den Standardtyp aus. Standardmäßig erstellt die Konsole ein FIFO Thema.

5. Geben Sie im Feld Name den Namen des SNS Themas ein. Geben Sie für dieses Tutorial high_temp_notice ein.

6. Scrollen Sie zum Ende der Seite und wählen Sie Create topic (Erstellen eines Themas) aus.

   In der Konsole wird die Seite Details geöffnet.

Erstellen Sie ein SNS Amazon-Abonnement.

1. Wählen Sie auf der Detailseite des Themas high_temp_notice die Option Abonnement erstellen.

2. Wählen Sie unter Abonnement erstellen im Abschnitt Details in der Protokollliste die Option aus SMS.

3. Geben Sie im Feld Endpunkt die Nummer eines Telefons ein, das Textnachrichten empfangen kann. Achten Sie darauf, dass Sie es so eingeben, dass es mit einem + beginnt, die Landes- und Ortsvorwahl enthält und keine anderen Satzzeichen enthält.

4. Wählen Sie Create subscription (Abonnement erstellen) aus.

Testen Sie die SNS Amazon-Benachrichtigung.

1. Wählen Sie in der SNSAmazon-Konsole im linken Navigationsbereich Themen aus.

2. Um die Detailseite des Themas zu öffnen, wählen Sie unter Themen in der Liste der Themen den Eintrag high_temp_notice aus.

3. Um die Seite Nachricht im Thema veröffentlichen zu öffnen, wählen Sie auf der Detailseite von high_temp_notice die Option Nachricht veröffentlichen aus.

4. Geben Sie unter Nachricht zum Thema veröffentlichen im Abschnitt Nachrichtentext im Feld Nachrichtentext, der an den Endpunkt gesendet werden soll, eine Kurznachricht ein.

5. Scrollen Sie auf der Seite nach unten und wählen Sie Nachricht veröffentlichen.

6. Vergewissern Sie sich auf dem Telefon mit der Nummer, die Sie zuvor bei der Erstellung des Abonnements verwendet haben, dass die Nachricht empfangen wurde.

Wenn Sie die Testnachricht nicht erhalten haben, überprüfen Sie die Telefonnummer und die Einstellungen Ihres Telefons.

Stellen Sie sicher, dass Sie Testnachrichten von der SNSAmazon-Konsole aus veröffentlichen können, bevor Sie mit dem Tutorial fortfahren.

Öffnen Sie den Regel-Hub der AWS IoT Konsole.

Wenn dies Ihre erste Regel ist, wählen Sie Erstellen oder Regel erstellen.

In Erstellen einer Regel:

1. Geben Sie unter Name temp_limit_notify ein.

   Denken Sie daran, dass ein Regelname in Ihrer Region AWS-Konto und in Ihrer Region eindeutig sein muss und keine Leerzeichen enthalten darf. Wir haben in diesem Namen einen Unterstrich verwendet, um die Wörter im Namen der Regel voneinander zu trennen.

2. Beschreiben Sie die Regel im Feld Beschreibung.

   Eine aussagekräftige Beschreibung macht es einfacher, sich daran zu erinnern, was diese Regel bewirkt und warum Sie sie erstellt haben. Die Beschreibung kann so lang wie nötig sein, also seien Sie so detailliert wie möglich.

In der Regelabfrageanweisung von Regel erstellen:

1. Wählen Sie unter SQL Version verwenden die Option 2016-03-23 aus.

2. Geben Sie im Bearbeitungsfeld Regelabfrageanweisung die folgende Anweisung ein:

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

   Diese Aussage:

   • Sucht nach MQTT Nachrichten mit einem Thema, das dem device/+/data Themenfilter entspricht und deren temperature Wert größer als 30 ist.

   • Wählt das zweite Element aus der Themenzeichenfolge aus und weist es dem device_id Feld zu.

   • Wählt das Wert temperature Feld aus der Nachrichtennutzlast aus und weist es dem reported_temperature Feld zu.

   • Erstellt einen konstanten Wert 30, der den Grenzwert darstellt, und weist ihn dem max_temperature Feld zu.

Um die Liste der Regelaktionen für diese Regel zu öffnen, wählen Sie unter Eine oder mehrere Aktionen festlegen die Option Aktion hinzufügen aus.

Wählen Sie unter Aktion auswählen die Option Nachricht als SNS Push-Benachrichtigung senden aus.

Um die Konfigurationsseite der ausgewählten Aktion zu öffnen, wählen Sie unten in der Aktionsliste die Option Aktion konfigurieren aus.

Gehen Sie in Aktion konfigurieren wie folgt vor:

1. Wählen Sie in SNSTarget die Option Select aus, suchen Sie Ihr SNS Thema mit dem Namen high_temp_notice und wählen Sie Select aus.

2. Wählen Sie unter Nachrichtenformat die Option. RAW

3. Wählen Sie unter Rolle auswählen oder erstellen, um AWS IoT Zugriff auf diese Aktion zu gewähren, die Option Rolle erstellen aus.

4. Geben Sie unter Neue Rolle erstellen im Feld Name einen eindeutigen Namen für die neue Rolle ein. Verwenden Sie für dieses Tutorial sns_rule_role.

5. Wählen Sie Rolle erstellen.

Wenn Sie dieses Tutorial wiederholen oder eine bestehende Rolle wiederverwenden, wählen Sie Rolle aktualisieren, bevor Sie fortfahren. Dadurch wird das Richtliniendokument der Rolle aktualisiert, sodass es mit dem SNS Ziel funktioniert.

Wählen Sie Aktion hinzufügen und kehren Sie zur Seite Regel erstellen zurück.

In der Kachel der neuen Aktion unter Eine Nachricht als SNS Push-Benachrichtigung senden finden Sie das SNS Thema, das in Ihrer Regel aufgerufen wird.

Dies ist die einzige Regelaktion, die Sie zu dieser Regel hinzufügen werden.

Um die Regel zu erstellen und diesen Schritt abzuschließen, scrollen Sie unter Regel erstellen nach unten und wählen Sie Regel erstellen aus.

Abonnieren Sie im MQTT Client in der AWS IoT Konsole die Eingabethemen, in diesem Falldevice/+/data.

1. Wählen Sie im MQTT Client unter Abonnements die Option Thema abonnieren aus.

2. Geben Sie im Abonnementthema das Thema des Eingabethemenfilters device/+/data ein.

3. Belassen Sie die übrigen Felder auf ihren Standardeinstellungen.

4. Wählen Sie Thema abonnieren aus.

   In der Spalte Abonnements wird device/+/data unter In einem Thema veröffentlichen angezeigt.

Veröffentlichen Sie eine Nachricht zum Eingabethema mit einer bestimmten Geräte-ID, device/32/data. Sie können nicht zu MQTT Themen veröffentlichen, die Platzhalterzeichen enthalten.

1. Wählen Sie im MQTT Client unter Abonnements die Option Als Thema veröffentlichen aus.

2. Geben Sie im Feld Veröffentlichen den Namen des Eingabethemas device/32/data ein.

3. Kopieren Sie die hier gezeigten Beispieldaten und fügen Sie die Beispieldaten in das Bearbeitungsfeld unter dem Themennamen ein.

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

4. Wählen Sie Im Thema veröffentlichen, um Ihre MQTT Nachricht zu veröffentlichen.

Bestätigen Sie, dass die Textnachricht gesendet wurde.

1. Im MQTT Client befindet sich unter Abonnements ein grüner Punkt neben dem Thema, das Sie zuvor abonniert haben.

   Der grüne Punkt zeigt an, dass eine oder mehrere neue Nachrichten eingegangen sind, seit Sie sie das letzte Mal angesehen haben.

2. Wählen Sie unter Abonnements die Option Gerät/+/Daten aus, um zu überprüfen, ob die Nutzlast der Nachricht mit dem übereinstimmt, was Sie gerade veröffentlicht haben, und wie folgt aussieht:

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

3. Überprüfe das Telefon, mit dem du das SNS Thema abonniert hast, und vergewissere dich, dass der Inhalt der Nachrichten-Payload wie folgt aussieht:

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

   Beachten Sie, dass es sich bei dem device_id Wert um eine Zeichenfolge in Anführungszeichen handelt und der Wert temperature numerisch ist. Das liegt daran, dass die topic() Funktion die Zeichenfolge aus dem Themennamen der Eingabenachricht extrahiert hat, während der temperature Wert den numerischen Wert aus der Nutzlast der Eingabenachricht verwendet.

   Wenn Sie den Wert zu einem numerischen device_id Wert machen möchten, ersetzen Sie topic(2) in der Anweisung zur Regelabfrage durch:

   cast(topic(2) AS DECIMAL)

   Beachten Sie, dass die Umwandlung des topic(2) Werts in einen numerischen DECIMAL Wert nur funktioniert, wenn dieser Teil des Themas nur numerische Zeichen enthält.

Versuchen Sie, eine MQTT Nachricht zu senden, bei der die Temperatur den Grenzwert nicht überschreitet.

1. Wählen Sie im MQTT Client unter Abonnements die Option Als Thema veröffentlichen aus.

2. Geben Sie im Feld Veröffentlichen den Namen des Eingabethemas device/33/data ein.

3. Kopieren Sie die hier gezeigten Beispieldaten und fügen Sie die Beispieldaten in das Bearbeitungsfeld unter dem Themennamen ein.

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

4. Um Ihre MQTT Nachricht zu senden, wählen Sie Im Thema veröffentlichen.

Sie sollten die Nachricht sehen, die Sie im device/+/data Abonnement gesendet haben. Da der Temperaturwert jedoch unter der Höchsttemperatur in der Regelabfrageanweisung liegt, sollten Sie keine Textnachricht erhalten.

Wenn Sie nicht das richtige Verhalten feststellen, lesen Sie die Tipps zur Fehlerbehebung.