# Ereignisse im Status der Geräteregistrierung
<a name="iot-sidewalk-device-events"></a>

Ereignisse mit dem Status der Geräteregistrierung veröffentlichen Ereignisbenachrichtigungen, wenn sich der Status der Geräteregistrierung ändert, z. B. wenn ein Sidewalk-Gerät bereitgestellt oder registriert wurde. Die Ereignisse liefern Ihnen Informationen über die verschiedenen Status, die das Gerät von der Bereitstellung bis zur Registrierung durchläuft.

## So funktionieren Ereignisse mit dem Status der Geräteregistrierung
<a name="iot-sidewalk-device-events-work"></a>

Wenn Sie Ihr Sidewalk-Gerät bei Amazon Sidewalk und AWS IoT Wireless einbinden, führt AWS IoT Wireless einen `create`-Vorgang aus und fügt Ihr Sidewalk-Gerät zu Ihrem AWS-Konto hinzu. Ihr Gerät wechselt dann in den Status „Bereitgestellt“ und `eventType` wird `provisioned`. Weitere Informationen zum Onboarding von Geräten finden Sie unter [Erste Schritte mit AWS IoT Core für Amazon Sidewalk](sidewalk-getting-started.md).

Nachdem das Gerät `provisioned` wurde, führt Amazon Sidewalk einen `register`-Vorgang durch, bei dem Ihr Sidewalk-Gerät mit AWS IoT Wireless registriert wird. Der Registrierungsprozess beginnt, wo die Verschlüsselung und die Sitzungsschlüssel mit AWS IoT eingerichtet werden. Wenn das Gerät registriert ist, wird `eventType` das `registered` und Ihr Gerät ist einsatzbereit.

Nachdem das Gerät `registered` wurde, kann Sidewalk eine `deregister`-Anfrage Ihr Gerät senden. AWS IoT Wireless erfüllt dann die Anfrage und ändert den Gerätestatus wieder auf `provisioned`. Weitere Informationen über die Gerätezustände finden Sie unter [DeviceState](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SidewalkDeviceMetadata.html#iotwireless-Type-SidewalkDeviceMetadata-DeviceState). 

## Aktiviert Benachrichtigungen für Ereignisse mit dem Status der Geräteregistrierung
<a name="iot-sidewalk-device-events-enable"></a>

Bevor Subscriber der reservierten Geräteregistrierungs-Themen Nachrichten empfangen können, müssen Sie für sie Ereignisbenachrichtigungen über die AWS-Managementkonsole oder mithilfe der API oder CLI aktivieren. Sie können diese Ereignisse für alle Sidewalk-Ressourcen in Ihren AWS-Konto oder für ausgewählte Ressourcen aktivieren. Weitere Informationen darüber, wie Sie diese Ereignisse einrichten finden Sie unter [Ereignisse für Drahtlos-Ressourcen aktivieren](iot-wireless-control-events.md). 

## Format der MQTT-Themen für Ereignisse mit dem Status der Geräteregistrierung
<a name="iot-sidewalk-device-events-mqtt"></a>

Um Sie über Ereignisse mit dem Status der Geräteregistrierung zu informieren, können Sie für MQTT reservierte Themen abonnieren, die mit einem Dollarzeichen ($) beginnen. Weitere Informationen finden Sie unter [MQTT-Themen](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) im *AWS IoT-Entwicklerhandbuch*. 

Reservierte MQTT-Themen für Ereignisse mit dem Status der Sidewalk-Geräteregistrierung verwenden das folgende Format:
+ Für Themen auf Ressourcenebene:

  `$aws/iotwireless/events/{eventName}/{eventType}/sidewalk/wireless_devices`
+ Für Kennungsthemen:

  `$aws/iotwireless/events/{eventName}/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}`

Wobei gilt:

**{eventName}**  
{eventName} muss `device_registation_state` sein.

**{eventType}**  
{eventType} kann `provisioned` oder `registered` sein.

**{resourceType}**  
{resourceType} kann `sidewalk_accounts` oder `wireless_devices` sein.

**{resourceID}**  
{resourceID} ist `amazon_id` für {resourceType} von `sidewalk_accounts` und `wireless_device_id` für {resourceType} von `wireless_devices`.

Sie können auch das Platzhalterzeichen `+` verwenden, um mehrere Themen gleichzeitig zu abonnieren. Das Platzhalterzeichen `+` entspricht einer beliebigen Zeichenfolge in der Ebene, die das Zeichen enthält. Wenn Sie beispielsweise über alle möglichen Ereignistypen (`provisioned` und `registered`) und für alle Geräte, die mit einer bestimmten Amazon-ID registriert sind, informiert werden möchten, können Sie den folgenden Themenfilter verwenden:

`$aws/iotwireless/events/device_registration_state/+/sidewalk/sidewalk_accounts/amazon_id/+`

**Anmerkung**  
Sie können das Platzhalterzeichen `#` nicht verwenden, um die reservierten Themen zu abonnieren. Weitere Informationen zu Themenfiltern finden Sie unter [MQTT-Themenfilter](https://docs.aws.amazon.com/iot/latest/developerguide/topicfilters.html) im *AWS IoT-Entwicklerhandbuch*.

## Nachrichten-Payload für Ereignisse im Zusammenhang mit dem Status der Geräteregistrierung
<a name="iot-sidewalk-device-events-json"></a>

Nachdem Sie Benachrichtigungen für Ereignisse mit dem Status der Geräteregistrierung aktiviert haben, werden Ereignisbenachrichtigungen über MQTT mit einer JSON-Nutzlast veröffentlicht. Diese Ereignisse enthalten die folgende Beispielnutzlast:

```
{    
    "eventId": "string", 
    "eventType": "provisioned|registered", 
    "WirelessDeviceId": "string",
    "timestamp": "timestamp",

    // Event-specific fields
    "operation": "create|deregister|register", 
    "Sidewalk": {
        "AmazonId": "string",
        "SidewalkManufacturingSn": "string"
    }
}
```

Die Nutzlast enthält die folgenden Attribute:

**eventId**  
Eine eindeutige Ereignis-ID (Zeichenfolge).

**eventType**  
Die Art des Ereignisses, das eingetreten ist. Kann `provisioned` oder `registered` sein.

**wirelessDeviceId**  
Die Kennung des drahtlosen Geräts.

**timestamp**  
Der Unix-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.

**Operation beschleunigen**  
Die Operation, die das Ereignis ausgelöst hat. Gültige Werte sind `create`, `register` und `deregister`. 

**sidewalk**  
Die Sidewalk-Amazon-ID oder `SidewalkManufacturingSn` für die Sie Ereignisbenachrichtigungen erhalten möchten.