Generieren von Ereignisnachrichten Ereignisse aktivieren für AWS IoT

Ereignismeldungen

Dieser Abschnitt enthält Informationen zu Nachrichten, die veröffentlicht werden AWS IoT , wenn Dinge oder Jobs aktualisiert oder geändert werden. Informationen zu dem AWS IoT Events Dienst, mit dem Sie Melder einrichten können, mit denen Sie Ihre Geräte auf Ausfälle oder Betriebsänderungen überwachen und bei deren Auftreten Aktionen auslösen können, finden Sie unter AWS IoT Events.

Generieren von Ereignisnachrichten

AWS IoT veröffentlicht Ereignismeldungen, wenn bestimmte Ereignisse eintreten. Beispielsweise werden Ereignisse von der Registry generiert, wenn Geräte hinzugefügt, aktualisiert oder gelöscht werden. Jedes Ereignis bewirkt, dass eine einzelne Ereignismeldung gesendet wird. Ereignismeldungen werden mit einer JSON-Nutzlast über MQTT veröffentlicht. Der Inhalt der Nutzlast hängt von der Art des Ereignisses ab.

Anmerkung

Ereignismeldungen werden garantiert einmal veröffentlicht. Es ist möglich, dass sie mehr als einmal veröffentlicht werden. Die Reihenfolge von Ereignismeldungen ist nicht garantiert.

Richtlinie für den Empfang von Ereignisnachrichten

Um Ereignisnachrichten zu empfangen, muss Ihr Gerät eine entsprechende Richtlinie verwenden, die es ihm ermöglicht, eine Verbindung zum AWS IoT Gerätegateway herzustellen und MQTT-Ereignisthemen zu abonnieren. Sie müssen auch die entsprechenden Themenfilter abonnieren.

Es folgt ein Beispiel der für den Empfang von Ereignissen zum Lebenszyklus erforderlichen Richtlinie:


{
    "Version":"2012-10-17",
    "Statement":[{
        "Effect":"Allow",
        "Action":[
            "iot:Subscribe",
            "iot:Receive"
        ],
        "Resource":[
            "arn:aws:iot:region:account:/$aws/events/*"
        ]
    }]
}

Ereignisse aktivieren für AWS IoT

Bevor Abonnenten der reservierten Themen Nachrichten empfangen können, müssen Sie mithilfe der API AWS Management Console oder CLI Ereignisnachrichten von oder aktivieren. Informationen zu den Ereignisnachrichten, die mit den verschiedenen Optionen verwaltet werden, finden Sie in der Tabelle der Einstellungen für die AWS IoT Ereigniskonfiguration.

Um Ereignismeldungen zu aktivieren, wechseln Sie in der AWS IoT Konsole zur Registerkarte Einstellungen und wählen Sie dann im Abschnitt Ereignisbasierte Nachrichten die Option Ereignisse verwalten aus. Sie können die Ereignisse angeben, die Sie verwalten möchten.
Um zu steuern, welche Ereignistypen mithilfe der API oder CLI veröffentlicht werden, rufen Sie die UpdateEventConfigurations API auf oder verwenden Sie den update-event-configurations CLI-Befehl. Beispielsweise:
```
aws iot update-event-configurations --event-configurations "{\"THING\":{\"Enabled\": true}}"
```

Anmerkung

Alle Anführungszeichen („“) werden durch Backslashes (\) umgangen.

Sie können die aktuelle Ereigniskonfiguration abrufen, indem Sie die DescribeEventConfigurations API aufrufen oder den describe-event-configurations CLI-Befehl verwenden. Zum Beispiel: .


aws iot describe-event-configurations

Tabelle der Einstellungen für die AWS IoT -Ereigniskonfiguration

Ereigniskategorie (AWS IoT Konsole: Einstellungen: Ereignisbasierte Nachrichten)	`eventConfigurations`-Schlüsselwert (AWS CLI/API)	Topic der Ereignismeldung
(Kann nur mit der AWS CLI/API konfiguriert werden)	`CA_CERTIFICATE`	`$aws/events/certificates/registered/caCertificateId`
(Kann nur mit der AWS CLI/API konfiguriert werden)	`CERTIFICATE`	`$aws/events/presence/connected/clientId`
(Kann nur mit der AWS CLI/API konfiguriert werden)	`CERTIFICATE`	`$aws/events/presence/disconnected/clientId`
(Kann nur mit der AWS CLI/API konfiguriert werden)	`CERTIFICATE`	`$aws/events/subscriptions/subscribed/clientId`
(Kann nur mit der AWS CLI/API konfiguriert werden)	`CERTIFICATE`	`$aws/events/subscriptions/unsubscribed/clientId`
Auftrag abgeschlossen, storniert	`JOB`	`$aws/events/job/jobID/canceled`
Auftrag abgeschlossen, storniert	`JOB`	`$aws/events/job/jobID/cancellation_in_progress`
Auftrag abgeschlossen, storniert	`JOB`	`$aws/events/job/jobID/completed`
Auftrag abgeschlossen, storniert	`JOB`	`$aws/events/job/jobID/deleted`
Auftrag abgeschlossen, storniert	`JOB`	`$aws/events/job/jobID/deletion_in_progress`
Auftragsausführung: erfolgreich, abgelehnt, storniert, entfernt	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/canceled`
Auftragsausführung: erfolgreich, abgelehnt, storniert, entfernt	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/deleted`
Auftragsausführung: erfolgreich, abgelehnt, storniert, entfernt	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/failed`
Auftragsausführung: erfolgreich, abgelehnt, storniert, entfernt	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/rejected`
Auftragsausführung: erfolgreich, abgelehnt, storniert, entfernt	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/removed`
Auftragsausführung: erfolgreich, abgelehnt, storniert, entfernt	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/succeeded`
Auftragsausführung: erfolgreich, abgelehnt, storniert, entfernt	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/timed_out`
Objekt: erstellt, aktualisiert, gelöscht	`THING`	`$aws/events/thing/thingName/created`
Objekt: erstellt, aktualisiert, gelöscht	`THING`	`$aws/events/thing/thingName/updated`
Objekt: erstellt, aktualisiert, gelöscht	`THING`	`$aws/events/thing/thingName/deleted`
Objektgruppe: hinzugefügt, entfernt	`THING_GROUP`	`$aws/events/thingGroup/thingGroupName/created`
Objektgruppe: hinzugefügt, entfernt	`THING_GROUP`	`$aws/events/thingGroup/thingGroupName/updated`
Objektgruppe: hinzugefügt, entfernt	`THING_GROUP`	`$aws/events/thingGroup/thingGroupName/deleted`
Objektgruppenhierarchie: hinzugefügt, entfernt	`THING_GROUP_HIERARCHY`	`$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/added`
Objektgruppenhierarchie: hinzugefügt, entfernt	`THING_GROUP_HIERARCHY`	`$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/removed`
Mitgliedschaft in einer Objektgruppe: hinzugefügt, entfernt	`THING_GROUP_MEMBERSHIP`	`$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/added`
Mitgliedschaft in einer Objektgruppe: hinzugefügt, entfernt	`THING_GROUP_MEMBERSHIP`	`$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/removed`
Objekttyp: erstellt, aktualisiert, gelöscht	`THING_TYPE`	`$aws/events/thingType/thingTypeName/created`
Objekttyp: erstellt, aktualisiert, gelöscht	`THING_TYPE`	`$aws/events/thingType/thingTypeName/updated`
Objekttyp: erstellt, aktualisiert, gelöscht	`THING_TYPE`	`$aws/events/thingType/thingTypeName/deleted`
Zuordnung des Objekttyps: hinzugefügt, entfernt	`THING_TYPE_ASSOCIATION`	`$aws/events/thingTypeAssociation/thing/thingName/thingType/thingTypeName/added` `$aws/events/thingTypeAssociation/thing/thingName/thingType/thingTypeName/removed`

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Location Solver und Geräte-Payload

Registry-Ereignisse