

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
<a name="iot-events"></a>

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
<a name="iot-events-how"></a>

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
<a name="iot-events-policy"></a>

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
<a name="iot-events-enable"></a>

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 (\\) 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
```<a name="iot-events-settings-table"></a>

**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`<br />`$aws/events/thingTypeAssociation/thing/{{thingName}}/thingType/{{thingTypeName}}/removed` | 