Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# 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](https://aws.amazon.com/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:us-east-1:123456789012:/$aws/events/*"
]
}
]
}
```
## Ereignisse aktivieren für AWS IoT
Bevor Abonnenten der reservierten Themen Nachrichten empfangen können, müssen Sie mithilfe der API AWS-Managementkonsole 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](#iot-events-settings-table).
+ Um Ereignismeldungen zu aktivieren, wechseln Sie in der AWS IoT Konsole zur Registerkarte [Einstellungen](https://console.aws.amazon.com//iot/home#/settings) 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](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateEventConfigurations.html)API auf oder verwenden Sie den **update-event-configurations** CLI-Befehl. Beispiel:
```
aws iot update-event-configurations --event-configurations "{\"THING\":{\"Enabled\": true}}"
```
**Anmerkung**
Alle Anführungszeichen („“) werden durch Backslashes (\$1) umgangen.
Sie können die aktuelle Ereigniskonfiguration abrufen, indem Sie die [DescribeEventConfigurations](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeEventConfigurations.html)API aufrufen oder den **describe-event-configurations** CLI-Befehl verwenden. 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` |
# Registry-Ereignisse
Die Registry kann Ereignismeldungen veröffentlichen, wenn Objekte, Objekttypen und Objektgruppen erstellt, aktualisiert oder gelöscht werden. Diese Ereignisse sind jedoch standardmäßig nicht verfügbar. Weitere Informationen darüber, wie Sie diese Ereignisse aktivieren, finden Sie unter [Ereignisse aktivieren für AWS IoT](iot-events.md#iot-events-enable).
**Topics**
+ [Objektereignisse](#registry-events-thing)
+ [Objekttypereignisse](#registry-events-thingtype)
+ [Objektgruppenereignisse](#registry-events-thinggroup)
## Objektereignisse
**Sache Created/Updated/Deleted**
Die Registry veröffentlicht die folgenden Ereignismeldungen, wenn Objekte erstellt, aktualisiert oder gelöscht werden:
+ `$aws/events/thing/thingName/created`
+ `$aws/events/thing/thingName/updated`
+ `$aws/events/thing/thingName/deleted`
Die Meldungen enthalten die folgende Beispielnutzlast:
```
{
"eventType" : "THING_EVENT",
"eventId" : "f5ae9b94-8b8e-4d8e-8c8f-b3266dd89853",
"timestamp" : 1234567890123,
"operation" : "CREATED|UPDATED|DELETED",
"accountId" : "123456789012",
"thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5",
"thingName" : "MyThing",
"versionNumber" : 1,
"thingTypeName" : null,
"attributes": {
"attribute3": "value3",
"attribute1": "value1",
"attribute2": "value2"
}
}
```
Die Nutzlasten enthalten die folgenden Attribute:
eventType
Auf „THING\$1EVENT“ festgelegt.
eventId
Eine eindeutige Ereignis-ID (Zeichenfolge).
timestamp
Der UNIX-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.
operation
Die Operation, die das Ereignis ausgelöst hat. Folgende sind gültige Werte:
+ CREATED
+ UPDATED
+ GELÖSCHT
accountId
Dein AWS-Konto Ausweis.
thingId
Die ID des gerade erstellten, aktualisierten oder gelöschten Objekts.
thingName
Der Name des gerade erstellten, aktualisierten oder gelöschten Objekts.
versionNumber
Die Version des gerade erstellten, aktualisierten oder gelöschten Objekts. Dieser Wert wird bei der Erstellung eines Objekts auf 1 festgelegt. Er wird bei jeder Aktualisierung des Objekts um 1 erhöht.
thingTypeName
Der mit dem Objekt verknüpfte Objekttyp, sofern vorhanden. Andernfalls `null`.
Attribute
Eine Reihe von mit dem Objekt verknüpften Name-Wert-Paaren.
## Objekttypereignisse
**Topics**
+ [Art der Sache Created/Updated/Deprecated/Undeprecated/Deleted](#registry-events-thingtype-crud)
+ [Objekttyp einem Objekt zugeordnet/nicht zugeordnet](#registry-events-thingtype-assoc)
### Art der Sache Created/Updated/Deprecated/Undeprecated/Deleted
Die Registrierung veröffentlicht die folgenden Ereignismeldungen, wenn Dingtypen erstellt, aktualisiert, veraltet, nicht mehr unterstützt oder gelöscht werden:
+ `$aws/events/thingType/thingTypeName/created`
+ `$aws/events/thingType/thingTypeName/updated`
+ `$aws/events/thingType/thingTypeName/deleted`
Die Nachricht enthält die folgende Beispielnutzlast:
```
{
"eventType" : "THING_TYPE_EVENT",
"eventId" : "8827376c-4b05-49a3-9b3b-733729df7ed5",
"timestamp" : 1234567890123,
"operation" : "CREATED|UPDATED|DELETED",
"accountId" : "123456789012",
"thingTypeId" : "c530ae83-32aa-4592-94d3-da29879d1aac",
"thingTypeName" : "MyThingType",
"isDeprecated" : false|true,
"deprecationDate" : null,
"searchableAttributes" : [ "attribute1", "attribute2", "attribute3" ],
"propagatingAttributes": [
{
"userPropertyKey": "key",
"thingAttribute": "model"
},
{
"userPropertyKey": "key",
"connectionAttribute": "iot:ClientId"
}
],
"description" : "My thing type"
}
```
Die Nutzlasten enthalten die folgenden Attribute:
eventType
Auf „THING\$1TYPE\$1EVENT“ festgelegt.
eventId
Eine eindeutige Ereignis-ID (Zeichenfolge).
timestamp
Der UNIX-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.
operation
Die Operation, die das Ereignis ausgelöst hat. Folgende sind gültige Werte:
+ CREATED
+ UPDATED
+ GELÖSCHT
accountId
Deine ID. AWS-Konto
thingTypeId
Die ID des Dingtyps, der erstellt, aktualisiert, veraltet oder gelöscht wird.
thingTypeName
Der Name des Dingtyps, der erstellt, aktualisiert, veraltet oder gelöscht wird.
isDeprecated
`true`, wenn der Objekttyp veraltet ist. Andernfalls `false`.
deprecationDate
Der UNIX-Zeitstempel für den Zeitpunkt, an dem der Objekttyp als veraltet eingestuft wurde.
searchableAttributes
Eine Reihe von mit dem Objekttyp verknüpften Name-Wert-Paaren, die für Suchen verwendet werden können.
Attribute propagieren
Eine Liste von Attributen, die sich verbreiten. Ein propagierendes Attribut kann ein Dingattribut, ein Verbindungsattribut und einen Benutzereigenschaftsschlüssel enthalten. Weitere Informationen finden Sie unter [Hinzufügen von propagierenden Attributen zur Nachrichtenanreicherung](https://docs.aws.amazon.com//iot/latest/developerguide/thing-types-propagating-attributes.html).
description
Eine Beschreibung des Objekttyps.
### Objekttyp einem Objekt zugeordnet/nicht zugeordnet
Die Registry veröffentlicht die folgenden Ereignismeldungen, wenn ein Objekttyp einem Objekt zugeordnet wird oder die Zuordnung entfernt wird.
+ `$aws/events/thingTypeAssociation/thing/thingName/thingType/typeName/added`
+ `$aws/events/thingTypeAssociation/thing/thingName/thingType/typeName/removed`
Im Folgenden sehen Sie ein Beispiel für eine `added`-Nutzlast. Die Nutzlasten für `removed`-Nachrichten sind ähnlich.
```
{
"eventId" : "87f8e095-531c-47b3-aab5-5171364d138d",
"eventType" : "THING_TYPE_ASSOCIATION_EVENT",
"operation" : "ADDED",
"thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5",
"thingName": "myThing",
"thingTypeName" : "MyThingType",
"timestamp" : 1234567890123,
}
```
Die Nutzlasten enthalten die folgenden Attribute:
eventId
Eine eindeutige Ereignis-ID (Zeichenfolge).
eventType
Auf "THING\$1TYPE\$1ASSOCIATION\$1EVENT" gesetzt.
operation
Die Operation, die das Ereignis ausgelöst hat. Folgende sind gültige Werte:
+ HINZUGEFÜGT
+ ENTFERNT
thingId
Die ID des Objekts, dessen Zuordnung geändert wurde.
thingName
Der Name des Objekts, dessen Zuordnung geändert wurde.
thingTypeName
Der Objekttyp, der dem Objekt zugeordnet oder nicht mehr zugeordnet ist.
timestamp
Der UNIX-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.
## Objektgruppenereignisse
**Topics**
+ [Dinggruppe Created/Updated/Deleted](#registry-events-thinggroup-crud)
+ [Objekt, das einer Objektgruppe hinzugefügt/aus dieser entfernt wird](#registry-events-thinggroup-addremove)
+ [Objektgruppe, die einer Objektgruppe hinzugefügt/aus dieser gelöscht wird](#registry-events-thinggroup-adddelete)
### Dinggruppe Created/Updated/Deleted
Die Registry veröffentlicht die folgenden Ereignismeldungen, wenn eine Objektgruppe erstellt, aktualisiert oder gelöscht wird.
+ `$aws/events/thingGroup/groupName/created`
+ `$aws/events/thingGroup/groupName/updated`
+ `$aws/events/thingGroup/groupName/deleted`
Im Folgenden sehen Sie ein Beispiel für eine `updated`-Nutzlast. Die Nutzlasten für `created`- und `deleted`-Nachrichten sind ähnlich.
```
{
"eventType": "THING_GROUP_EVENT",
"eventId": "8b9ea8626aeaa1e42100f3f32b975899",
"timestamp": 1603995417409,
"operation": "UPDATED",
"accountId": "571EXAMPLE833",
"thingGroupId": "8757eec8-bb37-4cca-a6fa-403b003d139f",
"thingGroupName": "Tg_level5",
"versionNumber": 3,
"parentGroupName": "Tg_level4",
"parentGroupId": "5fce366a-7875-4c0e-870b-79d8d1dce119",
"description": "New description for Tg_level5",
"rootToParentThingGroups": [
{
"groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/TgTopLevel",
"groupId": "36aa0482-f80d-4e13-9bff-1c0a75c055f6"
},
{
"groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level1",
"groupId": "bc1643e1-5a85-4eac-b45a-92509cbe2a77"
},
{
"groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level2",
"groupId": "0476f3d2-9beb-48bb-ae2c-ea8bd6458158"
},
{
"groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level3",
"groupId": "1d9d4ffe-a6b0-48d6-9de6-2e54d1eae78f"
},
{
"groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level4",
"groupId": "5fce366a-7875-4c0e-870b-79d8d1dce119"
}
],
"attributes": {
"attribute1": "value1",
"attribute3": "value3",
"attribute2": "value2"
},
"dynamicGroupMappingId": null
}
```
Die Nutzlasten enthalten die folgenden Attribute:
eventType
Auf „THING\$1GROUP\$1EVENT“ festgelegt.
eventId
Eine eindeutige Ereignis-ID (Zeichenfolge).
timestamp
Der UNIX-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.
operation
Die Operation, die das Ereignis ausgelöst hat. Folgende sind gültige Werte:
+ CREATED
+ UPDATED
+ GELÖSCHT
accountId
Ihr AWS-Konto Ausweis.
thingGroupId
Die ID der gerade erstellten, aktualisierten oder gelöschten Objektgruppe.
thingGroupName
Der Name der gerade erstellten, aktualisierten oder gelöschten Objektgruppe.
versionNumber
Die Version der Objektgruppe. Dieser Wert wird bei der Erstellung einer Objektgruppe auf 1 festgelegt. Er wird bei jeder Aktualisierung der Objektgruppe um 1 erhöht.
parentGroupName
Der Name der übergeordneten Objektgruppe (sofern vorhanden).
parentGroupId
Die ID der übergeordneten Objektgruppe (sofern vorhanden).
description
Eine Beschreibung der Objektgruppe.
rootToParentThingGroups
Ein Array mit Informationen zur übergeordneten Objektgruppe. Es gibt ein Element für jede übergeordnete Objektgruppe. Der erste Eintrag bezieht sich auf die Stamm-Objektgruppe und dies wird fortgesetzt, bis die übergeordnete Objektgruppe erreicht wurde. Jeder Eintrag enthält die Werte `groupArn` und `groupId` der Objektgruppe.
Attribute
Eine Reihe von mit der Objektgruppe verknüpften Name-Wert-Paaren.
### Objekt, das einer Objektgruppe hinzugefügt/aus dieser entfernt wird
Die Registry veröffentlicht die folgenden Ereignismeldungen, wenn ein Objekt einer Objektgruppe hinzugefügt oder aus dieser entfernt wird.
+ `$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/added`
+ `$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/removed`
Die Meldungen enthalten die folgende Beispielnutzlast:
```
{
"eventType" : "THING_GROUP_MEMBERSHIP_EVENT",
"eventId" : "d684bd5f-6f6e-48e1-950c-766ac7f02fd1",
"timestamp" : 1234567890123,
"operation" : "ADDED|REMOVED",
"accountId" : "123456789012",
"groupArn" : "arn:aws:iot:ap-northeast-2:123456789012:thinggroup/MyChildThingGroup",
"groupId" : "06838589-373f-4312-b1f2-53f2192291c4",
"thingArn" : "arn:aws:iot:ap-northeast-2:123456789012:thing/MyThing",
"thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5",
"membershipId" : "8505ebf8-4d32-4286-80e9-c23a4a16bbd8"
}
```
Die Nutzlasten enthalten die folgenden Attribute:
eventType
Auf „THING\$1GROUP\$1MEMBERSHIP\$1EVENT“ festgelegt.
eventId
Die Ereignis-ID.
Zeitstempel
Der UNIX-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.
operation
`ADDED`, wenn ein Objekt zu einer Objektgruppe hinzugefügt wird, `REMOVED`, wenn ein Objekt aus einer Objektgruppe entfernt wird.
accountId
Ihr AWS-Konto Ausweis.
groupArn
Der ARN der Objektgruppe.
groupId
Die ID der Gruppe.
thingArn
Der ARN des Objekts, das der Objektgruppe hinzugefügt bzw. daraus entfernt wurde.
thingId
Die ID des Objekts, das der Objektgruppe hinzugefügt bzw. daraus entfernt wurde.
membershipId
Eine ID, die die Beziehung zwischen dem Objekt und der Objektgruppe angibt. Dieser Wert wird generiert, wenn Sie ein Objekt zu einer Objektgruppe hinzufügen.
### Objektgruppe, die einer Objektgruppe hinzugefügt/aus dieser gelöscht wird
Die Registry veröffentlicht die folgenden Ereignismeldungen, wenn eine Objektgruppe einer anderen Objektgruppe hinzugefügt oder aus dieser entfernt wird.
+ `$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/added`
+ `$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/removed`
Die Nachricht enthält die folgende Beispielnutzlast:
```
{
"eventType" : "THING_GROUP_HIERARCHY_EVENT",
"eventId" : "264192c7-b573-46ef-ab7b-489fcd47da41",
"timestamp" : 1234567890123,
"operation" : "ADDED|REMOVED",
"accountId" : "123456789012",
"thingGroupId" : "8f82a106-6b1d-4331-8984-a84db5f6f8cb",
"thingGroupName" : "MyRootThingGroup",
"childGroupId" : "06838589-373f-4312-b1f2-53f2192291c4",
"childGroupName" : "MyChildThingGroup"
}
```
Die Nutzlasten enthalten die folgenden Attribute:
eventType
Auf „THING\$1GROUP\$1HIERARCHY\$1EVENT“ festgelegt.
eventId
Die Ereignis-ID.
Zeitstempel
Der UNIX-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.
operation
`ADDED`, wenn ein Objekt zu einer Objektgruppe hinzugefügt wird, `REMOVED`, wenn ein Objekt aus einer Objektgruppe entfernt wird.
accountId
Ihr AWS-Konto Ausweis.
thingGroupId
Die ID der übergeordneten Objektgruppe.
thingGroupName
Der Name der übergeordneten Objektgruppe.
childGroupId
Die ID der untergeordneten Objektgruppe.
childGroupName
Der Name der untergeordneten Objektgruppe.
# Auftragsereignisse
Der AWS IoT Jobs-Dienst veröffentlicht zu bestimmten Themen im MQTT-Protokoll, wenn Jobs ausstehen, abgeschlossen oder storniert sind und wenn ein Gerät bei der Ausführung eines Jobs Erfolg oder Misserfolg meldet. Geräte oder Management- und Überwachungsanwendungen können den Status der Aufträge nachverfolgen, indem sie diese Topics abonnieren.
**Aktivieren von Ereignisbenachrichtigungen**
Antwortnachrichten des AWS IoT Jobs-Dienstes werden nicht über den Message Broker weitergeleitet und können auch nicht von anderen Clients oder Regeln abonniert werden. Verwenden Sie die Topics `notify` and `notify-next`, um Nachrichten zu Auftragsaktivitäten zu abonnieren. Weitere Informationen über auftragsbezogene Topics finden Sie unter [Auftragsthemen](reserved-topics.md#reserved-topics-job).
Um über Job-Updates informiert zu werden, aktivieren Sie diese Job-Ereignisse mithilfe der AWS-Managementkonsole, oder mithilfe der API oder CLI. Weitere Informationen finden Sie unter [Ereignisse aktivieren für AWS IoT](iot-events.md#iot-events-enable).
**Funktionsweise von Auftragsereignissen**
Da das Abbrechen oder Löschen eines Auftrags einige Zeit in Anspruch nehmen kann, werden zwei Nachrichten gesendet, um den Start und das Ende einer Anfrage anzuzeigen. Wenn zum Beispiel eine Abbruchanfrage gestartet wird, wird eine Nachricht an das `$aws/events/job/jobID/cancellation_in_progress`-Thema gesendet. Wenn die Abbruchanfrage abgeschlossen ist, wird eine Nachricht an das `$aws/events/job/jobID/canceled`-Thema gesendet.
Ein ähnlicher Prozess findet bei einer Anfrage zur Löschung eines Auftrags statt. Management- und Überwachungsanwendungen können diese Themen abonnieren, um den Status von Aufträgen nachzuverfolgen. Für weitere Informationen zur Veröffentlichung und zum Abonnement von MQTT-Themen vgl. [Gerätekommunikationsprotokolle](protocols.md).
**Auftragsereignistypen**
Die folgenden Beispiele zeigen die verschiedenen Arten von Auftragsereignissen:
**Job Completed/Canceled/Deleted**
Der AWS IoT Jobs-Service veröffentlicht eine Nachricht zu einem MQTT-Thema, wenn ein Job abgeschlossen, storniert oder gelöscht wird oder wenn gerade eine Stornierung oder Löschung im Gange ist:
+ `$aws/events/job/jobID/completed`
+ `$aws/events/job/jobID/canceled`
+ `$aws/events/job/jobID/deleted`
+ `$aws/events/job/jobID/cancellation_in_progress`
+ `$aws/events/job/jobID/deletion_in_progress`
Die `completed`-Nachricht enthält die folgende Beispielnutzlast:
```
{
"eventType": "JOB",
"eventId": "7364ffd1-8b65-4824-85d5-6c14686c97c6",
"timestamp": 1234567890,
"operation": "completed",
"jobId": "27450507-bf6f-4012-92af-bb8a1c8c4484",
"status": "COMPLETED",
"targetSelection": "SNAPSHOT|CONTINUOUS",
"targets": [
"arn:aws:iot:us-east-1:123456789012:thing/a39f6f91-70cf-4bd2-a381-9c66df1a80d0",
"arn:aws:iot:us-east-1:123456789012:thinggroup/2fc4c0a4-6e45-4525-a238-0fe8d3dd21bb"
],
"description": "My Job Description",
"completedAt": 1234567890123,
"createdAt": 1234567890123,
"lastUpdatedAt": 1234567890123,
"jobProcessDetails": {
"numberOfCanceledThings": 0,
"numberOfRejectedThings": 0,
"numberOfFailedThings": 0,
"numberOfRemovedThings": 0,
"numberOfSucceededThings": 3
}
}
```
Die `canceled`-Nachricht enthält die folgende Beispielnutzlast.
```
{
"eventType": "JOB",
"eventId": "568d2ade-2e9c-46e6-a115-18afa1286b06",
"timestamp": 1234567890,
"operation": "canceled",
"jobId": "4d2a531a-da2e-47bb-8b9e-ff5adcd53ef0",
"status": "CANCELED",
"targetSelection": "SNAPSHOT|CONTINUOUS",
"targets": [
"arn:aws:iot:us-east-1:123456789012:thing/Thing0-947b9c0c-ff10-4a80-b4b3-cd33d0145a0f",
"arn:aws:iot:us-east-1:123456789012:thinggroup/ThingGroup1-95c644d5-1621-41a6-9aa5-ad2de581d18f"
],
"description": "My job description",
"createdAt": 1234567890123,
"lastUpdatedAt": 1234567890123
}
```
Die `deleted`-Nachricht enthält die folgende Beispielnutzlast.
```
{
"eventType": "JOB",
"eventId": "568d2ade-2e9c-46e6-a115-18afa1286b06",
"timestamp": 1234567890,
"operation": "deleted",
"jobId": "4d2a531a-da2e-47bb-8b9e-ff5adcd53ef0",
"status": "DELETED",
"targetSelection": "SNAPSHOT|CONTINUOUS",
"targets": [
"arn:aws:iot:us-east-1:123456789012:thing/Thing0-947b9c0c-ff10-4a80-b4b3-cd33d0145a0f",
"arn:aws:iot:us-east-1:123456789012:thinggroup/ThingGroup1-95c644d5-1621-41a6-9aa5-ad2de581d18f"
],
"description": "My job description",
"createdAt": 1234567890123,
"lastUpdatedAt": 1234567890123,
"comment": "Comment for this operation"
}
```
Die `cancellation_in_progress`-Nachricht enthält die folgende Beispielnutzlast:
```
{
"eventType": "JOB",
"eventId": "568d2ade-2e9c-46e6-a115-18afa1286b06",
"timestamp": 1234567890,
"operation": "cancellation_in_progress",
"jobId": "4d2a531a-da2e-47bb-8b9e-ff5adcd53ef0",
"status": "CANCELLATION_IN_PROGRESS",
"targetSelection": "SNAPSHOT|CONTINUOUS",
"targets": [
"arn:aws:iot:us-east-1:123456789012:thing/Thing0-947b9c0c-ff10-4a80-b4b3-cd33d0145a0f",
"arn:aws:iot:us-east-1:123456789012:thinggroup/ThingGroup1-95c644d5-1621-41a6-9aa5-ad2de581d18f"
],
"description": "My job description",
"createdAt": 1234567890123,
"lastUpdatedAt": 1234567890123,
"comment": "Comment for this operation"
}
```
Die `deletion_in_progress`-Nachricht enthält die folgende Beispielnutzlast:
```
{
"eventType": "JOB",
"eventId": "568d2ade-2e9c-46e6-a115-18afa1286b06",
"timestamp": 1234567890,
"operation": "deletion_in_progress",
"jobId": "4d2a531a-da2e-47bb-8b9e-ff5adcd53ef0",
"status": "DELETION_IN_PROGRESS",
"targetSelection": "SNAPSHOT|CONTINUOUS",
"targets": [
"arn:aws:iot:us-east-1:123456789012:thing/Thing0-947b9c0c-ff10-4a80-b4b3-cd33d0145a0f",
"arn:aws:iot:us-east-1:123456789012:thinggroup/ThingGroup1-95c644d5-1621-41a6-9aa5-ad2de581d18f"
],
"description": "My job description",
"createdAt": 1234567890123,
"lastUpdatedAt": 1234567890123,
"comment": "Comment for this operation"
}
```
**Endstatus der Auftragsausführung**
Der AWS IoT Jobs-Dienst veröffentlicht eine Meldung, wenn ein Gerät eine Jobausführung auf den Terminalstatus aktualisiert:
+ `$aws/events/jobExecution/jobID/succeeded`
+ `$aws/events/jobExecution/jobID/failed`
+ `$aws/events/jobExecution/jobID/rejected`
+ `$aws/events/jobExecution/jobID/canceled`
+ `$aws/events/jobExecution/jobID/timed_out`
+ `$aws/events/jobExecution/jobID/removed`
+ `$aws/events/jobExecution/jobID/deleted`
Die Nachricht enthält die folgende Beispielnutzlast:
```
{
"eventType": "JOB_EXECUTION",
"eventId": "cca89fa5-8a7f-4ced-8c20-5e653afb3572",
"timestamp": 1234567890,
"operation": "succeeded|failed|rejected|canceled|removed|timed_out",
"jobId": "154b39e5-60b0-48a4-9b73-f6f8dd032d27",
"thingArn": "arn:aws:iot:us-east-1:123456789012:myThing/6d639fbc-8f85-4a90-924d-a2867f8366a7",
"status": "SUCCEEDED|FAILED|REJECTED|CANCELED|REMOVED|TIMED_OUT",
"statusDetails": {
"key": "value"
}
}
```
# Ereignisse bei der Ausführung von Befehlen
AWS IoT veröffentlicht Ereignismeldungen zu MQTT-Themen, wenn sich der Status der Befehlsausführungen ändert. Sie können diese Ereignisse verwenden, um den Fortschritt der Befehlsausführung zu überwachen und Anwendungen zu erstellen, die auf Statusänderungen reagieren.
**Themen zu Ereignissen zur Befehlsausführung**
Ereignisse zur Befehlsausführung werden unter dem folgenden MQTT-Thema veröffentlicht:
```
$aws/events/commandExecution/commandId/status
```
Wobei Folgendes gilt:
+ `commandId`ist der Bezeichner des Befehls.
+ `status`ist der Status der Befehlsausführung. Folgende Werte sind zulässig: `CREATED`, `IN_PROGRESS`, `SUCCEEDED`, `FAILED`, `REJECTED`, `TIMED_OUT`.
Abonnieren Sie das folgende Thema mit Platzhalterzeichen, um Benachrichtigungen zu allen Befehlen und allen Status zu erhalten:
```
$aws/events/commandExecution/+/#
```
**Meldung über das Ereignis zur Befehlsausführung**
Wenn sich der Status der Befehlsausführung ändert, wird eine Ereignismeldung zum entsprechenden MQTT-Thema AWS IoT veröffentlicht. Die Nachricht enthält die folgende Beispielnutzlast:
```
{
"executionId": "2bd65c51-4cfd-49e4-9310-d5cbfdbc8554",
"status": "FAILED",
"statusReason": {
"reasonCode": "DEVICE_TOO_BUSY",
"reasonDescription": ""
},
"eventType": "COMMAND_EXECUTION",
"commandArn": "arn:aws:iot:us-east-1:123456789012:command/0b9d9ddf-e873-43a9-8e2c-9fe004a90086",
"targetArn": "arn:aws:iot:us-east-1:123456789012:thing/5006c3fc-de96-4def-8427-7eee36c6f2bd",
"timestamp": 1717708862107
}
```
Die Nutzlast enthält die folgenden Attribute:
**Ausführungs-ID**
Ein eindeutiger Bezeichner für die Befehlsausführung (Zeichenfolge).
**status**
Der Status der Befehlsausführung. Folgende Werte sind zulässig: `CREATED`, `IN_PROGRESS`, `SUCCEEDED`, `FAILED`, `REJECTED`, `TIMED_OUT`.
**StatusGrund**
Ein Objekt, das zusätzliche Informationen über den Status enthält, falls verfügbar. Enthält `reasonCode` und `reasonDescription` Felder.
**eventType**
Auf „COMMAND\$1EXECUTION“ eingestellt.
**Befehl: ARN**
Der Amazon-Ressourcenname (ARN) des Befehls.
**targetArn**
Der ARN des Zielgeräts (Ding oder Client) für die Befehlsausführung.
**timestamp**
Der UNIX-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.
# Ereignisse im Lebenszyklus
AWS IoT kann Lebenszyklusereignisse zu den MQTT-Themen veröffentlichen. Diese Ereignisse stehen standardmäßig zur Verfügung und können nicht deaktiviert werden.
**Anmerkung**
Nachrichten zum Lebenszyklus können ohne feste Reihenfolge gesendet werden. Unter Umständen erhalten Sie einzelne Nachrichten auch mehrfach.
`thingName`wird nur aufgenommen, wenn der Client über die [exklusive](exclusive-thing.md) Funktion eine Verbindung herstellt.
**Topics**
+ [„Verbinden/Verbindung trennen“-Ereignisse](#connect-disconnect)
+ [Ereignis mit fehlgeschlagenem Verbindungsversuch](#connect-authfailure-event)
+ [„Abonnieren/Abonnement beenden“-Ereignisse](#subscribe-unsubscribe-events)
## „Verbinden/Verbindung trennen“-Ereignisse
**Anmerkung**
Mit der Flottenindizierung von AWS IoT Device Management können Sie nach Dingen suchen, aggregierte Abfragen ausführen und dynamische Gruppen auf der Grundlage von Connect/Disconnect Dingereignissen erstellen. Weitere Informationen finden Sie unter [Flottenindizierung](https://docs.aws.amazon.com//iot/latest/developerguide/iot-indexing.html).
AWS IoT veröffentlicht eine Nachricht zu den folgenden MQTT-Themen, wenn ein Client eine Verbindung herstellt oder trennt:
+ `$aws/events/presence/connected/clientId`: Ein Client, der mit dem Message Broker verbunden ist.
+ `$aws/events/presence/disconnected/clientId`: Ein Client, dessen Verbindung mit dem Message Broker getrennt wurde
Im Folgenden finden Sie eine Liste von JSON-Elementen, die in den zum Thema veröffentlichten connection/disconnection Nachrichten enthalten sind. `$aws/events/presence/connected/clientId`
**clientId**
Die Client-ID des Clients, der eine Verbindung herstellt oder trennt
Clients IDs , die \$1 oder \$1 enthalten, empfangen keine Lebenszyklusereignisse.
**thingName**
Der Name deiner IoT-Sache. `thingName`wird nur aufgenommen, wenn der Client über die [exklusive Ding-Funktion eine](exclusive-thing.md) Verbindung herstellt.
**clientInitiatedDisconnect**
„True“, wenn der Client die Verbindungstrennung initiiert hat. Ansonsten „false“. Nur in Trennungsnachrichten.
**disconnectReason**
Der Grund, warum der Client die Verbindung trennt. Nur in Trennungsnachrichten. Die folgende Tabelle enthält gültige Werte und gibt an, ob der Broker beim Verbindungsabbruch [Last Will and Testament (LWT)-Nachrichten](mqtt.md#mqtt-lwt) sendet.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot/latest/developerguide/life-cycle-events.html)
1 Wenn das Gerät vor dem Auftreten dieses Fehlers über eine aktive Verbindung verfügte.
2 Um LWT-Nachrichten (Last Will and Testament) `preventWillMessage=true` zu verhindern, legen Sie fest, dass das standardmäßige `DeleteConnection` LWT-Sendeverhalten der API außer Kraft gesetzt wird.
**eventType**
Der Ereignistyp. Gültige Werte sind `connected` oder `disconnected`.
**ipAddress**
Die IP-Adresse des verbindenden Clients. Dies kann im IPv4 oder IPv6 -Format sein. Nur in Verbindungsnachrichten.
**principalIdentifier**
Die zur Anmeldung verwendeten Anmeldeinformationen. Für gegenseitige TLS-Authentifizierungszertifikate ist dies die Zertifikat-ID. Für andere Verbindungsarten sind dies die IAM-Anmeldeinformationen.
**sessionIdentifier**
Ein global eindeutiger Bezeichner AWS IoT , der für die Dauer der Sitzung existiert.
**Zeitstempel**
Eine ungefähre Schätzung, wann das Ereignis eingetreten ist.
**versionNumber**
Die Versionsnummer für das Lebenszyklusereignis. Dies ist ein monoton ansteigender langer Ganzzahlwert für jede Client-ID-Verbindung. Die Versionsnummer kann von einem Abonnenten verwendet werden, um die Reihenfolge der Lebenszyklusereignisse festzustellen.
Die Verbindungs- und Trennungsnachrichten für eine Client-Verbindung haben dieselbe Versionsnummer.
Die Versionsnummer kann Werte überspringen und wird nicht zwingend konsistent für jedes Ereignis um 1 erhöht.
Wenn ein Client etwa eine Stunde lang nicht verbunden ist, wird die Versionsnummer auf 0 zurückgesetzt. Bei persistenten Sitzungen wird die Versionsnummer auf 0 zurückgesetzt, nachdem ein Client länger als die für die persistente Sitzung konfigurierte Verbindung time-to-live (TTL) getrennt wurde.
Eine Verbindungsnachricht hat die folgende Struktur.
```
{
"clientId": "186b5",
"thingName": "exampleThing",
"timestamp": 1573002230757,
"eventType": "connected",
"sessionIdentifier": "00000000-0000-0000-0000-000000000000",
"principalIdentifier": "12345678901234567890123456789012",
"ipAddress": "192.0.2.0",
"versionNumber": 0
}
```
Eine Trennungsnachricht hat die folgende Struktur.
```
{
"clientId": "186b5",
"thingName": "exampleThing",
"timestamp": 1573002340451,
"eventType": "disconnected",
"sessionIdentifier": "00000000-0000-0000-0000-000000000000",
"principalIdentifier": "12345678901234567890123456789012",
"clientInitiatedDisconnect": true,
"disconnectReason": "CLIENT_INITIATED_DISCONNECT",
"versionNumber": 0
}
```
### Umgang mit Client-Verbindungstrennungen
Es ist eine bewährte Methode, für Lebenszyklusereignisse (einschließlich [Last Will and Testament (LWT)-Nachrichten)](mqtt.md) stets einen implementierten Wartestatus zu verwenden. Wenn eine getrennte Verbindung signalisiert wird, sollte Ihr Code eine gewisse Zeit warten und überprüfen, ob ein Gerät noch offline ist, bevor Maßnahmen ergriffen werden. Eine Möglichkeit dazu ist das Verwenden von [SQS-Verzögerungswarteschlangen](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-delay-queues.html). Wenn ein Client ein LWT- oder Lebenszyklusereignis erhält, können Sie eine Nachricht für (beispielsweise) ca. 5 Sekunden in eine Warteschlange stellen. Wenn die Nachricht verfügbar ist und verarbeitet wird (durch Lambda oder einen anderen Service), können Sie zunächst überprüfen, ob das Gerät immer noch offline ist, bevor Sie zu weiteren Maßnahmen greifen.
## Ereignis mit fehlgeschlagenem Verbindungsversuch
AWS IoT veröffentlicht eine Nachricht zum folgenden MQTT-Thema, wenn ein Client nicht autorisiert ist, eine Verbindung herzustellen, oder wenn ein Testament konfiguriert ist und der Client nicht berechtigt ist, zu diesem letzten Testament-Thema zu veröffentlichen.
```
$aws/events/presence/connect_failed/clientId
```
Im Folgenden finden Sie eine Liste der JSON-Elemente, die in den Verbindungsautorisierungsnachrichten enthalten sind, die zu `$aws/events/presence/connect_failed/clientId` diesem Thema veröffentlicht wurden.
**clientId**
Die Client-ID des Clients, der versucht hat, eine Verbindung herzustellen, aber fehlgeschlagen ist.
Clients IDs , die \$1 oder \$1 enthalten, empfangen keine Lebenszyklusereignisse.
**thingName**
Der Name deiner IoT-Sache. `thingName`wird nur aufgenommen, wenn der Client über die [exklusive Ding-Funktion eine](exclusive-thing.md) Verbindung herstellt.
**Zeitstempel**
Eine ungefähre Schätzung, wann das Ereignis eingetreten ist.
**eventType**
Der Ereignistyp. Gültiger Wert ist`connect_failed`.
**connectFailureReason**
Der Grund, warum die Verbindung fehlschlägt. Gültiger Wert ist`AUTHORIZATION_FAILED`.
**principalIdentifier**
Die zur Anmeldung verwendeten Anmeldeinformationen. Für gegenseitige TLS-Authentifizierungszertifikate ist dies die Zertifikat-ID. Für andere Verbindungsarten sind dies die IAM-Anmeldeinformationen.
**sessionIdentifier**
Ein global eindeutiger Bezeichner AWS IoT , der für die Dauer der Sitzung existiert.
**ipAddress**
Die IP-Adresse des verbindenden Clients. Dies kann in unserem IPv4 IPv6 Format sein. Nur in Verbindungsnachrichten.
Eine Meldung über einen Verbindungsfehler hat die folgende Struktur.
```
{
"clientId": "186b5",
"thingName": "exampleThing",
"timestamp": 1460065214626,
"eventType": "connect_failed",
"connectFailureReason": "AUTHORIZATION_FAILED",
"principalIdentifier": "12345678901234567890123456789012",
"sessionIdentifier": "00000000-0000-0000-0000-000000000000",
"ipAddress" : "192.0.2.0"
}
```
## „Abonnieren/Abonnement beenden“-Ereignisse
AWS IoT veröffentlicht eine Nachricht zum folgenden MQTT-Thema, wenn ein Client ein MQTT-Thema abonniert oder abbestellt:
```
$aws/events/subscriptions/subscribed/clientId
```
oder
```
$aws/events/subscriptions/unsubscribed/clientId
```
Hierbei ist `clientId` die MQTT-Client-ID, über die eine Verbindung zum AWS IoT Message Broker hergestellt wird.
Die im Topic veröffentlichte Nachricht weist die folgende Struktur auf:
```
{
"clientId": "186b5",
"thingName": "exampleThing",
"timestamp": 1460065214626,
"eventType": "subscribed" | "unsubscribed",
"sessionIdentifier": "00000000-0000-0000-0000-000000000000",
"principalIdentifier": "12345678901234567890123456789012",
"topics" : ["foo/bar","device/data","dog/cat"]
}
```
Die nachfolgende Liste enthält JSON-Elemente, die in „Abonnieren/Abonnement abbestellen“-Nachrichten enthalten sind, die an die Topics `$aws/events/subscriptions/subscribed/clientId` und `$aws/events/subscriptions/unsubscribed/clientId` gesendet werden.
clientId
Die Client-ID des Clients, der ein Topic abonniert oder das Abonnement abbestellt.
Clients IDs , die \$1 oder \$1 enthalten, empfangen keine Lebenszyklusereignisse.
thingName
Der Name deiner IoT-Sache. `thingName`wird nur aufgenommen, wenn der Client über die [exklusive Ding-Funktion eine](exclusive-thing.md) Verbindung herstellt.
eventType
Der Ereignistyp. Gültige Werte sind `subscribed` oder `unsubscribed`.
principalIdentifier
Die zur Anmeldung verwendeten Anmeldeinformationen. Für gegenseitige TLS-Authentifizierungszertifikate ist dies die Zertifikat-ID. Für andere Verbindungsarten sind dies die IAM-Anmeldeinformationen.
sessionIdentifier
Ein global eindeutiger Bezeichner AWS IoT , der für die Dauer der Sitzung existiert.
Zeitstempel
Eine ungefähre Schätzung, wann das Ereignis eingetreten ist.
topics
Ein Array der vom Client abonnierten MQTT-Topics.
**Anmerkung**
Nachrichten zum Lebenszyklus können ohne feste Reihenfolge gesendet werden. Unter Umständen erhalten Sie einzelne Nachrichten auch mehrfach.