Tutorial: Senden einer Amazon SNS-Benachrichtigung

Erstellen Sie ein Amazon-SNS-Thema.

1. Melden Sie sich bei der Amazon-SNS-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 Amazon-SNS-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 Protokoll-Liste die Option SMS aus.

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 Amazon SNS-Benachrichtigung.

1. Wählen Sie in der Amazon SNS-Konsole im linken Navigationsbereich Themen.

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 Amazon SNS-Konsole aus veröffentlichen können, bevor Sie mit dem Tutorial fortfahren.

Öffnen Sie den Rules 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 innerhalb Ihres AWS-Konto und 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:

   • Lauscht auf 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 Eine 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 unter SNS-Ziel die Option Auswählen aus, suchen Sie Ihr SNS-Thema mit dem Namen high_temp_notice und wählen Sie Auswählen aus.

2. Wählen Sie unter Nachrichtenformat das Format 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 aus.

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 Ihre Regel aufrufen 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 Fall device/+/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 keine Beiträge in MQTT-Themen veröffentlichen, die Platzhalterzeichen enthalten.

1. Wählen Sie im MQTT-Client unter Abonnements die Option In einem Thema veröffentlichen.

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 In Thema veröffentlichen aus, 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üfen Sie das Telefon, mit dem Sie das SNS-Thema abonniert haben, und vergewissern Sie sich, dass der Inhalt der Nutzlast der Nachricht so 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, in der die Temperatur den Grenzwert nicht überschreitet.

1. Wählen Sie im MQTT-Client unter Abonnements die Option In einem Thema veröffentlichen.

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.