# AWS IoT Core für Amazon Sidewalk
AWS IoT Core für Amazon Sidewalk bietet die Cloud-Services, mit denen Sie Ihre Sidewalk-Endgeräte mit der AWS Cloud verbinden und andere AWS-Services verwenden können.
Amazon Sidewalk ist ein sicheres, gemeinsam genutztes Netzwerk, über das Geräte in Ihrer Community eine Verbindung herzustellen und in Verbindung bleiben können. Amazon Sidewalk überträgt Daten zwischen Sidewalk-Endgeräten und Sidewalk-Gateways sowie zwischen Sidewalk-Gateways und der Sidewalk-Cloud.
## Zugriff auf AWS IoT Core für Amazon Sidewalk
Sie können Ihre Sidewalk-Endgeräte mithilfe der Konsole oder der AWS IoT Wireless-API-Operationen in AWS IoT eingliedern. Nach dem Onboarding Ihrer Geräte werden ihre Nachrichten an AWS IoT Core gesendet. Anschließend können Sie mit der Entwicklung Ihrer Geschäftsanwendungen in der AWS-Cloud beginnen, die die Daten von Ihren Amazon-Sidewalk-Endgeräten verwendet.
**Verwenden der Konsole**
Melden Sie sich bei der AWS-Managementkonsole an und navigieren Sie zur Seite [Geräte](https://console.aws.amazon.com/iot/home#/wireless/devices) auf der AWS IoT-Konsole, um Ihre Sidewalk-Endgeräte zu integrieren. Sobald Ihre Geräte eingegliedert sind, können Sie sie auf dieser Seite der IoT-Konsole anzeigen und verwalten.
**Verwenden der API oder CLI**
Mithilfe der [AWS IoT Wireless-API-Operationen](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/) können Sie sowohl Sidewalk- als auch LoRaWAN-Geräte eingliedern. Die AWS IoT Wireless-API, auf der AWS IoT Core basiert, wird vom AWS-SDK unterstützt. Weitere Informationen finden Sie unter [AWS-SDKs und Toolkits](https://aws.amazon.com/getting-started/tools-sdks/).
Sie können die AWS CLI verwenden, um Befehle für das Onboarding und die Verwaltung Ihrer Sidewalk-Endgeräte auszuführen. Weitere Informationen finden Sie in der [AWS IoT Wireless CLI-Referenz](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html).
## AWS IoT Core für Amazon Sidewalk – Regionen und Endpunkte
Amazon Sidewalk ist nur in der `us-east-1` AWS-Region verfügbar. AWS IoT Core für Amazon Sidewalk bietet Unterstützung für API-Endpunkte der Steuerebene und der Datenebene in dieser Region. Die API-Endpunkte der Datenebene unterscheiden sich je nach AWS-Konto. Weitere Informationen finden Sie unter [AWS IoT Wireless-Service-Endpunkte](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#iot-wireless_region) in *Allgemeine AWS-Referenz*.
AWS IoT Core für Amazon Sidewalk verfügt über Kontingente, die für Gerätedaten gelten, die zwischen dem Gerät und der AWS Cloud übertragen werden, sowie über die maximale Anzahl an TPS für die AWS IoT Wireless-API-Operationen. Weitere Informationen finden Sie unter [AWS IoT Wireless-Quotas](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#wireless-limits) in der *Allgemeinen AWS-Referenz*.
## AWS IoT Core für Amazon Sidewalk – Preise
Wenn Sie sich bei AWS anmelden, können Sie gratis mit der Verwendung von AWS IoT Core für Amazon Sidewalk beginnen, indem Sie das [kostenlose Kontingent von AWS](https://aws.amazon.com/free/) nutzen.
Weitere Informationen zur allgemeinen Produktübersicht und den Preisen finden Sie unter [AWS IoT Core-Preise](https://aws.amazon.com/iot-core/pricing/).
# Was ist AWS IoT Core für Amazon Sidewalk?
Mit AWS IoT Core für Amazon Sidewalk können Sie die Amazon Sidewalk-Endgeräte in AWS IoT einbinden und diese verwalten und überwachen. Es verwaltet auch die Ziele, die Gerätedaten an andere AWS-Services senden.
## Merkmale von AWS IoT Core für Amazon Sidewalk
Mit AWS IoT Core für Amazon Sidewalk können Sie:
+ Sidewalk-Endgeräte mit der AWS IoT-Konsole, AWS IoT Core für Amazon Sidewalk-API-Operationen oder AWS CLI-Befehlen in AWS IoT integrieren.
+ Nutzen Sie die Features von AWS Cloud.
+ Erstellen Sie ein Ziel, das AWS IoT Regeln verwendet, um eingehende Nutzdatennachrichten zu verarbeiten und mit anderen AWS-Services zu interagieren.
+ Aktivieren Sie Ereignisbenachrichtigungen, um Meldungen über Ereignisse zu erhalten, z. B. wann Ihr Sidewalk-Endgerät bereitgestellt oder registriert wurde oder ob eine Downlink-Nachricht erfolgreich an Ihr Gerät zugestellt wurde.
+ Protokollieren und überwachen Sie die Sidewalk-Endgeräte in Echtzeit, gewinnen Sie nützliche Erkenntnisse und identifizieren und beheben Sie Fehler.
+ Sidewalk-Endgeräte einer AWS IoT Sache zuordnen, sodass Sie eine Darstellung des Geräts in der Cloud speichern können. Die in AWS IoT enthaltenen Features erleichtern das Suchen und Verwalten sowie den Zugriff auf andere AWS IoT Core Features.
Die folgenden Themen helfen Ihnen dabei, mehr über Amazon Sidewalk und AWS IoT Core für Amazon Sidewalk zu erfahren.
**Topics**
+ [Merkmale von AWS IoT Core für Amazon Sidewalk](#sidewalk-features)
+ [Was ist Amazon Sidewalk?](amazon-sidewalk-overview.md)
+ [Funktionsweise von AWS IoT Core für Amazon Sidewalk](iot-sidewalk-works.md)
# Was ist Amazon Sidewalk?
Amazon Sidewalk ist ein sicheres Community-Netzwerk, das Amazon Sidewalk Bridges wie kompatible Amazon Echo- und Ring-Geräte verwendet, um Cloud-Konnektivität für IoT-Geräte bereitzustellen. Amazon Sidewalk ermöglicht Konnektivität mit geringer Bandbreite und großer Reichweite zu Hause und darüber hinaus, indem es Bluetooth LE für die Kommunikation über kurze Entfernungen und LoRa- und FSK-Funkprotokolle mit 900 MHz-Frequenzen für größere Entfernungen nutzt.
Wenn Amazon Sidewalk aktiviert ist, kann dieses Netzwerk andere Sidewalk-Endgeräte in der Community unterstützen und für Anwendungen wie das Erfassen der Umgebung genutzt werden. Amazon Sidewalk hilft den Geräten, eine Verbindung herzustellen und zu halten.
## Merkmale von Amazon Sidewalk
Nachfolgend Features von Amazon Sidewalk:
+ Amazon Sidewalk erstellt ein Netzwerk mit geringer Bandbreite unter Verwendung von Sidewalk-Gateways, die Ring- und ausgewählte Echo-Geräte enthalten. Mit Hilfe von Gateways können Sie einen Teil der Internet-Bandbreite freigeben, der dann für die Anbindung von Endgeräten an das Netz genutzt wird.
+ Amazon Sidewalk bietet einen sicheren Netzwerkmechanismus mit mehreren Verschlüsselungs- und Sicherheitsebenen.
+ Amazon Sidewalk bietet einen einfachen Mechanismus, um die Teilnahme an Sidewalk zu aktivieren oder zu deaktivieren.
## Amazon Sidewalk-Konzepte
Im Folgenden sind einige wichtige Konzepte von Amazon Sidewalk aufgeführt.
**Sidewalk Gateways**
Sidewalk-Gateways oder Amazon Sidewalk Bridges leiten Daten zwischen Sidewalk-Endgeräten und der Cloud weiter. Gateways sind Amazon-Geräte, wie das Echo-Gerät oder die Ring Floodlight Cam, die SubG-CSS (asynchron, LDR), SubG-FSK (synchron, HDR) oder Bluetooth LE für die Sidewalk-Kommunikation unterstützen. Sidewalk-Gateways teilen sich einen Teil der Internetbandbreite mit der Sidewalk-Community, um Konnektivität zu einer Gruppe von Sidewalk-fähigen Geräten bereitzustellen.
**Sidewalk-Endgeräte**
Sidewalk-Endgeräte können Amazon Sidewalk nutzen, indem sie eine Verbindung zu Sidewalk-Gateways herstellen. Bei den Endgeräten handelt es sich um intelligente Produkte mit geringer Bandbreite und geringem Stromverbrauch, wie z. B. Sidewalk-fähige Leuchten oder Türschlösser.
Bestimmte Sidewalk-Gateways können auch als Endgeräte fungieren.
**Sidewalk-Netzwerkserver**
Der von Amazon betriebene Sidewalk-Netzwerkserver verifiziert die eingehenden Pakete und leitet Uplink- und Downlink-Meldungen an das gewünschte Ziel weiter, während das Sidewalk-Netzwerk zeitsynchronisiert bleibt.
## Weitere Informationen über Amazon Sidewalk
Weitere Informationen zu Amazon Sidewalk finden Sie auf den folgenden Webseiten:
+ [Amazon Sidewalk](https://www.amazon.com/Amazon-Sidewalk/b?ie=UTF8&node=21328123011)
+ [Dokumentation zu Amazon Sidewalk](https://docs.sidewalk.amazon/introduction/)
+ [AWS IoT Core für Amazon Sidewalk](https://aws.amazon.com/iot-core/sidewalk/)
# Funktionsweise von AWS IoT Core für Amazon Sidewalk
Mit AWS IoT Core für Amazon Sidewalk können Sie die Amazon Sidewalk-Endgeräte in AWS IoT einbinden und diese verwalten und überwachen. Es verwaltet auch die Ziele, die Gerätedaten an andere AWS-Service-Geräte senden
AWS IoT Core für Amazon Sidewalk bietet die Cloud-Services, mit denen Sie Ihre Sidewalk-Endgeräte mit der AWS Cloud verbinden und andere AWS-Services verwenden können. Sie können AWS IoT Core für Amazon Sidewalk auch verwenden, um die Sidewalk-Geräte zu verwalten und darauf Anwendungen zu überwachen und zu erstellen.
Sidewalk-Endgeräte kommunizieren mit AWS IoT Core über Sidewalk-Gateways. AWS IoT Core für Amazon Sidewalk verwaltet die Service- und Geräterichtlinien, die AWS IoT Core für die Verwaltung und Kommunikation mit den Sidewalk-Endgeräten und -Gateways benötigt. Es verwaltet auch die Ziele, die Gerätedaten an andere AWS-Service senden.
![\[alt text not found\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/images/iot-sidewalk.png)
## Erste Schritte mit AWS IoT Core für Amazon Sidewalk
Sie können die AWS IoT-Konsole, die AWS IoT Core für Amazon Sidewalk-API oder die AWS CLI verwenden, um Sidewalk-Endgeräte zu erstellen und zu integrieren und sie mit dem Sidewalk-Netzwerk zu verbinden. In den folgenden Themen finden Sie Informationen zu den ersten Schritten mit Amazon Sidewalk und der Integration von Endgeräten zu AWS IoT.
+
**[Erste Schritte mit AWS IoT Core für Amazon Sidewalk](sidewalk-getting-started.md)**
In diesem Thema werden die Voraussetzungen für das Onboarding Ihrer Sidewalk-Endgeräte beschrieben, der Arbeitsablauf mithilfe einer Sensorüberwachungsanwendung veranschaulicht und ein Überblick darüber gegeben, wie Sie Ihr Gerät mithilfe von AWS CLI-Befehlen einbinden können.
+
**[Herstellen einer Verbindung mit AWS IoT Core für Amazon Sidewalk](iot-sidewalk-onboard.md)**
In diesem Abschnitt werden die verschiedenen Schritte in der Einführung in den Onboarding-Workflow beschrieben und das Onboarding Ihrer Endgeräte mithilfe der Konsole sowie die API-Operationen beschrieben. Außerdem verbinden Sie Ihr Gerät und sehen sich Meldungen an, die zwischen Ihrem Gerät und AWS IoT Core für Amazon Sidewalk ausgetauscht werden.
+
**[Massenbereitstellungsgeräte mit AWS IoT Core für Amazon Sidewalk](sidewalk-bulk-provisioning.md)**
In diesem Abschnitt finden Sie eine detaillierte schrittweise Anleitung zur Massenbereitstellung Ihrer Sidewalk-Endgeräte mithilfe von AWS IoT Core für Amazon Sidewalk. Sie lernen den Workflow für die Massenbereitstellung kennen und erfahren, wie Sie eine große Anzahl von Sidewalk-Geräten einbinden.
## Weitere Informationen über AWS IoT Core für Amazon Sidewalk
Weitere Informationen zu AWS IoT Core für Amazon Sidewalk finden Sie auf den folgenden Webseiten:
+ [Amazon Sidewalk](https://www.amazon.com/Amazon-Sidewalk/b?ie=UTF8&node=21328123011)
+ [Dokumentation zu Amazon Sidewalk](https://docs.sidewalk.amazon/introduction/)
+ [AWS IoT Core für Amazon Sidewalk](https://aws.amazon.com/iot-core/sidewalk/)
# Erste Schritte mit AWS IoT Core für Amazon Sidewalk
In diesem Abschnitt erfahren Sie, wie Sie Endgeräte von Sidewalk mit AWS IoT Core für Amazon Sidewalk verbinden. Es wird erklärt, wie Sie ein Endgerät mit Amazon Sidewalk verbinden und Meldungen zwischen diesen Geräten weiterleiten können. Sie lernen die Beispielanwendung für Sidewalk kennen und erhalten einen Überblick über die Sensorüberwachung mit AWS IoT Core für Amazon Sidewalk. Die Beispielanwendung bietet ein Dashboard, mit dem Sie Änderungen der Sensortemperatur anzeigen und überwachen können.
![\[alt text not found\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/images/sidewalk-getting-started.png)
Die folgenden Themen erleichtern Ihnen den Einstieg in AWS IoT Core für Amazon Sidewalk.
**Topics**
+ [Testen des Tutorials zur Sensorüberwachung](sidewalk-gs-tutorial.md)
+ [Einführung in das Onboarding Ihrer Sidewalk-Geräte](sidewalk-gs-workflow.md)
# Testen des Tutorials zur Sensorüberwachung
Dieser Abschnitt bietet einen Überblick über die Beispielanwendung Amazon Sidewalk auf GitHub, die zeigt, wie Sie die Sensortemperatur überwachen. In diesem Tutorial verwenden Sie Skripte, die programmgesteuert die erforderlichen WLAN-Ressourcen erstellen, das Endgerät bereitstellen, die Binärdateien flashen und das Endgerät mit der Anwendung verbinden. Die Skripte, die die Befehle AWS CLI und Python verwenden, erstellen einen AWS CloudFormation Stack und WLAN-Ressourcen, flashen dann die Binärdateien und stellen die Anwendung auf Ihrem Hardware Development Kit (HDK) bereit.
Das folgende Diagramm zeigt, welche Schritte erforderlich sind, wenn Sie die [Beispielanwendung](https://github.com/aws-samples/aws-iot-core-for-amazon-sidewalk-sample-app) ausführen und das Sidewalk-Endgerät mit der Anwendung verbinden. *Detaillierte Anweisungen, einschließlich Voraussetzungen und Konfiguration für dieses Tutorial, finden Sie im [README-Dokument auf GitHub](https://github.com/aws-samples/amazon-sidewalk-sample-iot-app/blob/main/README.md).*
![\[alt text not found\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/images/sidewalk-sensor-monitoring.png)
# Einführung in das Onboarding Ihrer Sidewalk-Geräte
In diesem Abschnitt erfahren Sie, wie Sie Sidewalk-Endgeräte in AWS IoT Core für Amazon Sidewalk einbinden. Um Geräte zu integrieren, fügen Sie zunächst das Sidewalk-Gerät hinzu, stellen dann das Gerät bereit und registrieren es; verbinden Sie dann die Hardware mit der Cloud-Anwendung. Bevor Sie dieses Tutorial ausführen, lesen Sie es durch und schließen Sie [Installieren von Python und der AWS CLI](setting-up-iotwireless.md#wireless-onboard-prereq) ab.
Die folgenden Schritte zeigen, wie Sie Sidewalk-Endgeräte einbinden und mit AWS IoT Core für Amazon Sidewalk verbinden. Wenn Sie Geräte mit AWS CLI einbinden möchten, können Sie sich an den Beispielbefehlen in diesem Abschnitt orientieren. Informationen zum Onboarding von Geräten über die AWS IoT Konsole finden Sie unter [Herstellen einer Verbindung mit AWS IoT Core für Amazon Sidewalk](iot-sidewalk-onboard.md).
**Wichtig**
Um den gesamten Onboarding-Workflow durchzuführen, müssen Sie das Endgerät bereitstellen und registrieren und das Hardware Development Kit (HDK) anschließen. Weitere Informationen finden Sie unter [Bereitstellung und Registrierung des Endgeräts](https://docs.sidewalk.amazon/provisioning/) in der *Amazon* Sidewalk-Dokumentation.
**Topics**
+ [Schritt 1: Hinzufügen Ihres Geräts zu AWS IoT Core für Amazon Sidewalk](#iot-sidewalk-qsg-step1)
+ [Schritt 2: Erstellen eines Ziels für das Sidewalk-Endgerät](#iot-sidewalk-qsg-step2)
+ [Schritt 3: Bereitstellung und Registrierung des Endgeräts](#iot-sidewalk-qsg-step2)
+ [Schritt 4: Connect zu einem Sidewalk-Endgerät und Tauschen von Nachrichten](#iot-sidewalk-qsg-step4)
## Schritt 1: Hinzufügen Ihres Geräts zu AWS IoT Core für Amazon Sidewalk
Im Folgenden finden Sie eine Übersicht über die Schritte, die Sie ausführen, um das Sidewalk-Endgerät zu AWS IoT Core für Amazon Sidewalk hinzuzufügen. Speichern Sie die Informationen, die Sie über das Geräteprofil und das von Ihnen erstellte drahtlose Gerät erhalten. Sie verwenden diese Informationen, um das Endgerät bereitzustellen und zu registrieren. Weitere Informationen zu diesen Zuständen finden Sie unter [Hinzufügen Ihres Geräts zu AWS IoT Core für Amazon Sidewalk](iot-sidewalk-create-device.md).
1.
**Erstellen eines Geräteprofils**
Erstellen Sie ein Geräteprofil, das die gemeinsam genutzten Konfigurationen für die Sidewalk-Geräte enthält. Geben Sie bei der Erstellung des Profils a `name` für das Profil als alphanumerische Zeichenfolge an. Um ein Profil zu erstellen, gehen Sie entweder in der AWS IoT Konsole zur Registerkarte [Sidewalk der Profile-Hubs](https://console.aws.amazon.com/iot/home#/wireless/profiles?tab=sidewalk) und wählen **Profil erstellen** aus, oder verwenden Sie den [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html) API-Vorgang oder [https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html) CLI-Befehl, wie in diesem Beispiel gezeigt.
```
// Add your device profile using a name and the sidewalk object.
aws iotwireless create-device-profile --name sidewalk_profile --sidewalk {}
```
1.
**Erstellen Ihres Sidewalk-Endgeräts**
Erstellen Ihres Sidewalk-Endgeräts mit AWS IoT Core für Amazon Sidewalk. Geben Sie einen Zielnamen und die ID des Geräteprofils an, das Sie im vorherigen Schritt erhalten haben. Um ein Gerät hinzuzufügen, gehen Sie entweder in der AWS IoT Konsole zur Registerkarte [Sidewalk des Geräte-Hubs](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) und wählen **Gerät bereitstellen** aus, oder verwenden Sie den [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html) API-Vorgang oder den [https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html) CLI-Befehl, wie in diesem Beispiel gezeigt.
**Anmerkung**
Geben Sie einen Namen für Ihr Ziel an, der für Ihr AWS-Konto und AWS-Region einzigartig ist. Sie verwenden diesen Zielnamen, wenn Sie das Ziel zu AWS IoT Core für Amazon Sidewalk hinzufügen.
```
// Add your Sidewalk device by using the device profile ID.
aws iotwireless create-wireless-device --type "Sidewalk" --name sidewalk_device \
--destination-name SidewalkDestination \
--sidewalk DeviceProfileId="12345678-234a-45bc-67de-e8901234f0a1"
```
1.
**Rufen Sie Informationen zum Geräteprofil und zum drahtlosen Gerät ab**
Rufen Sie das Geräteprofil und die Informationen zum drahtlosen Gerät als JSON ab. Das JSON enthält Informationen zu den Gerätedetails, Gerätezertifikaten, privaten Schlüsseln, `DeviceTypeId` und der Sidewalk Manufacturing Serial Number (SMSN).
+ Wenn Sie die AWS IoT-Konsole verwenden, können Sie die Registerkarte [Sidewalk im Geräte-Hub](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) verwenden, um eine kombinierte JSON-Datei für das Sidewalk-Endgerät herunterzuladen.
+ Wenn Sie die API-Operationen verwenden, speichern Sie die Antworten, die Sie aus den API-Vorgängen erhalten haben, [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html)und [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html)als separate JSON-Dateien, z. B. *`device_profile.json`*und. `wireless_device.json`
```
// Store device profile information as a JSON file.
aws iotwireless get-device-profile \
--id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" > device_profile.json
// Store wireless device information as a JSON file.
aws iotwireless get-wireless-device --identifier-type WirelessDeviceId \
--identifier "23456789-abcd-0123-bcde-fabc012345678" > wireless_device.json
```
## Schritt 2: Erstellen eines Ziels für das Sidewalk-Endgerät
Im Folgenden finden Sie eine Übersicht über die Schritte, die Sie ausführen, um das Ziel zu AWS IoT Core für Amazon Sidewalk hinzuzufügen. Mithilfe von AWS-Managementkonsole oder AWS IoT Wireless-API-Operationen oder AWS CLI, führen Sie die folgenden Schritte aus, um eine AWS IoT-Regel und ein Ziel zu erstellen. Anschließend können Sie eine Verbindung zur Hardwareplattform herstellen und Nachrichten anzeigen und austauschen. Ein Beispiel für eine IAM-Rolle und AWS IoT-Regel, die für die AWS CLI-Beispiele in diesem Abschnitt verwendet wurden, finden Sie unter [Erstellen einer IAM-Rolle und einer IoT-Regel für Ihr Ziel](sidewalk-destination-rule-role.md).
1.
**Erstellen einer IAM-Rolle**
Erstellen Sie eine IAM-Rolle, die AWS IoT Core für Amazon Sidewalk die Berechtigung zum Senden von Daten an die AWS IoT-Regel erteilt. Verwenden Sie die [https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)-API-Operation oder den [https://docs.aws.amazon.com/cli/latest/reference/iam/create-role](https://docs.aws.amazon.com/cli/latest/reference/iam/create-role)-CLI-Befehl, um die Rolle zu erstellen. Sie können die Rolle als *`SidewalkRole`* benennen.
```
aws iam create-role --role-name lambda-ex \
--assume-role-policy-document file://lambda-trust-policy.json
```
1.
**Erstellen einer Regel für Ihr Ziel**
Erstellen Sie eine AWS IoT-Regel, die die Gerätedaten verarbeitet, und geben Sie das Thema an, zu dem Meldungen veröffentlicht werden. Sie werden Nachrichten zu diesem Thema sehen, nachdem Sie eine Verbindung zur Hardwareplattform hergestellt haben. Verwenden Sie den AWS IoT Core API-Vorgang, [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateTopicRule.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateTopicRule.html), oder den AWS CLI-Befehl, [https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html](https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html), um eine Regel für das Ziel zu erstellen.
```
aws iot create-topic-rule --rule-name Sidewalkrule \
--topic-rule-payload file://myrule.json
```
1.
**Erstellen eines Ziels**
Erstellen Sie ein Ziel, das das Sidewalk-Gerät mit der IoT-Regel verknüpft, die es für die Verwendung mit anderen AWS-Services verarbeitet. Sie können ein Ziel mithilfe des [Destinations-Hubs](https://console.aws.amazon.com/iot/home#/wireless/destinations) der AWS IoT Konsole, der [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html)API-Operation oder des [https://docs.aws.amazon.com/cli/latest/reference/create-destination.html](https://docs.aws.amazon.com/cli/latest/reference/create-destination.html)CLI-Befehls hinzufügen.
```
aws iotwireless create-destination --name SidewalkDestination \
--expression-type RuleName --expression SidewalkRule \
--role-arn arn:aws:iam::123456789012:role/SidewalkRole
```
## Schritt 3: Bereitstellung und Registrierung des Endgeräts
Mithilfe von Python-Befehlen können Sie Ihr Endgerät bereitstellen und registrieren. Das Bereitstellungsskript verwendet die JSON-Daten des Geräts, die Sie erhalten haben, um ein fertigungsbezogenes Binärbild zu generieren, das dann auf der Hardwareplatine gespeichert wird. Anschließend registrieren Sie Ihr Endgerät für die Verbindung mit der Hardwareplattform. Weitere Informationen finden Sie unter [Bereitstellung und Registrierung des Endgeräts](https://docs.sidewalk.amazon/provisioning/) in der *Amazon Sidewalk-Dokumentation*.
**Anmerkung**
Bei der Registrierung des Sidewalk-Endgeräts muss das Gateway bei Amazon Sidewalk angemeldet sein, und das Gateway und das Gerät müssen sich in Reichweite zueinander befinden.
## Schritt 4: Connect zu einem Sidewalk-Endgerät und Tauschen von Nachrichten
Nachdem Sie Ihr Endgerät registriert haben, können Sie Ihr Endgerät verbinden und mit dem Austausch von Nachrichten und Gerätedaten beginnen.
1.
**Dein Sidewalk-Endgerät verbinden**
Verbinden Sie das HDK an Ihren Computer, und folgen Sie den Anweisungen in der Herstellerdokumentation, um eine Verbindung zu Ihrem HDK herzustellen. Weitere Informationen finden Sie unter [Bereitstellung und Registrierung des Endgeräts](https://docs.sidewalk.amazon/provisioning/) in der *Amazon* Sidewalk-Dokumentation.
1.
**Nachrichten anzeigen und austauschen**
Verwenden Sie den MQTT-Client, um das in der Regel angegebene Thema zu abonnieren und die empfangene Nachricht anzusehen. Sie können auch den [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToWirelessDevice.html)API-Vorgang oder den [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-wireless-device.html)CLI-Befehl verwenden, um eine Downlink-Nachricht an das Gerät zu senden und den Verbindungsstatus zu überprüfen.
(Optional) Sie können das Ereignis zum Status der Nachrichtenzustellung aktivieren, um zu überprüfen, ob die Downlink-Nachricht erfolgreich empfangen wurde.
```
aws iotwireless send-data-to-wireless-device \
--id "" \
--payload-data "SGVsbG8gVG8gRGV2c2lt" \
--wireless-metadata Sidewalk={Seq=1,AckModeRetryDurationSecs=10}
```
# Herstellen einer Verbindung mit AWS IoT Core für Amazon Sidewalk
In diesem Abschnitt erfahren Sie, wie Sie Ihr Sidewalk-Endgerät eingliedern und Ihr Gerät anschließend mit dem Sidewalk-Netzwerk verbinden. Darin werden die Schritte beschrieben, die Sie im Onboarding-Tutorial ausführen, wie in [Einführung in das Onboarding Ihrer Sidewalk-Geräte](sidewalk-gs-workflow.md) beschrieben. Sie erfahren, wie Sie Geräte mithilfe der AWS IoT-Konsole und der AWS IoT Core für Amazon Sidewalk-API-Operationen eingliedern. Sie erfahren auch mehr über die AWS CLI-Befehle, mit denen diese Operationen ausgeführt werden.
## Voraussetzungen
Richten Sie Ihr AWS-Konto ein, um Ihr Endgerät und Ihr Ziel zu AWS IoT Core für Amazon Sidewalk hinzuzufügen. Richten Sie außerdem die AWS CLI ein, um diese Operationen mithilfe der AWS IoT Wireless-API oder der AWS CLI-Befehle auszuführen. Weitere Informationen über die Voraussetzungen und die Einrichtung finden Sie unter [Installieren von Python und der AWS CLI](setting-up-iotwireless.md#wireless-onboard-prereq).
**Anmerkung**
Richten Sie auch Ihr Sidewalk-Gateway und HDK ein, um den gesamten Onboarding-Workflow für die Bereitstellung und Registrierung Ihres Endgeräts vorzunehmen und eine Verbindung zu Ihrem Hardware Development Kit (HDK) herzustellen. *Weitere Informationen finden Sie unter [Einrichten des Hardware Development Kit (HDK)](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-hdk.html) und [Einrichten eines Sidewalk-Gateways](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-gateway.html) in der Dokumentation zu Amazon Sidewalk*.
## Beschreiben Ihrer Sidewalk-Ressourcen
Bevor Sie beginnen und die Ressourcen erstellen, ist es ratsam, die Namenskonvention Ihrer Sidewalk-Endgeräte, Geräteprofile und Ziele zu berücksichtigen. AWS IoT Core für Amazon Sidewalk weist Ihren erstellten Ressourcen eine eindeutige Kennung zu. Sie können ihnen jedoch aussagekräftigere Namen geben und eine Beschreibung oder optionale Tags hinzufügen, um sie leichter identifizieren und verwalten zu können.
**Anmerkung**
Der Zielname kann nach der Erstellung nicht mehr geändert werden. Verwenden Sie einen eindeutigen Namen für Ihr AWS-Konto und Ihre AWS-Region.
Weitere Informationen finden Sie unter [Beschreiben Ihrer AWS IoT Wireless-Ressourcen](iotwireless-describe-resources.md).
**Topics**
+ [Voraussetzungen](#sidewalk-connect-prereq)
+ [Beschreiben Ihrer Sidewalk-Ressourcen](#sidewalk-connect-resources)
+ [Hinzufügen Ihres Geräts zu AWS IoT Core für Amazon Sidewalk](iot-sidewalk-create-device.md)
+ [Hinzufügen eines Ziels zu Ihrem Sidewalk-Endgerät](iot-sidewalk-qsg-destination.md)
+ [Verbinden Ihres Sidewalk-Geräts und Anzeigen des Uplink-Metadatenformats](iot-sidewalk-connect-uplink-metadata.md)
# Hinzufügen Ihres Geräts zu AWS IoT Core für Amazon Sidewalk
Bevor Sie ein WLAN-Gerät erstellen, erstellen Sie zunächst ein Geräteprofil. Geräteprofile definieren die Gerätefunktionen und andere Parameter für Ihre Sidewalk-Geräte. Ein einzelnes Geräteprofil kann mehreren Geräten zugeordnet werden.
Wenn Sie ein Geräteprofil erstellt haben und Informationen über das Profil abrufen, wird eine `DeviceTypeId` ausgegeben. Wenn Sie Ihr Endgerät bereitstellen, verwenden Sie diese ID, die Gerätezertifikate, den öffentlichen Schlüssel des Anwendungsservers und die SMSN.
## Erstellen und Hinzufügen Ihres Geräts
1. Erstellen Sie ein Geräteprofil für Ihre Sidewalk-Endgeräte. Geben Sie eine alphanumerische Zeichenfolge als Profilnamen an, der für Ihre Sidewalk-Geräte verwendet werden soll. Das Profil hilft dabei, die Geräte zu identifizieren, denen es zugeordnet werden soll.
+ (Konsole) Wenn Sie Ihr Sidewalk-Gerät hinzufügen, können Sie auch ein neues Profil erstellen. Auf diese Weise können Sie Ihr Gerät schnell zu AWS IoT Core für Amazon Sidewalk hinzufügen und es einem Profil zuordnen.
+ (API) Verwenden Sie die `CreateDeviceProfile`-API-Operation, indem Sie einen Profilnamen und das Sidewalk-Objekt `sidewalk {}` angeben. Die API-Antwort enthält eine Profil-ID und einen ARN (Amazon-Ressourcennamen).
1. Hinzufügen Ihres drahtlosen Geräts zu AWS IoT Core für Amazon Sidewalk. Geben Sie einen Zielnamen ein und wählen Sie das Geräteprofil aus, das Sie im vorherigen Schritt erstellt haben.
+ (Konsole) Geben Sie beim Hinzufügen Ihres Sidewalk-Geräts einen Zielnamen ein und wählen Sie das erstellte Profil aus.
+ (API) Verwenden Sie die `CreateWirelessDevice`-API-Operation. Geben Sie einen Zielnamen und die ID des zuvor abgerufenen Geräteprofils an.
**Parameter des WLAN-Geräts**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/iot-sidewalk-create-device.html)
1. Rufen Sie die JSON-Datei ab, die die erforderlichen Informationen für die Bereitstellung Ihres Endgeräts enthält.
+ (Konsole) Laden Sie diese Datei von der Detailseite des erstellten Sidewalk-Geräts herunter.
+ (API) Verwenden Sie die `GetDeviceProfile`- und `GetWirelessDevice`-API-Operationen, um Informationen über Ihr Geräteprofil und Ihr WLAN-Gerät abzurufen. Speichern Sie die API-Antwortinformationen als JSON-Dateien, z. B. *`device_profile.json`*und *`wireless_device.json`*.
# Hinzufügen Ihres Geräteprofil und Ihres Sidewalk-Endgeräts
In diesem Abschnitt wird beschrieben, wie Sie ein Geräteprofil erstellen. Außerdem wird gezeigt, wie Sie die AWS IoT-Konsole und die AWS CLI verwenden, um Ihr Sidewalk-Endgerät zu AWS IoT Core für Amazon Sidewalk hinzuzufügen.
## Hinzufügen Ihres Sidewalk-Geräts (Konsole)
Wechseln Sie im [Geräte-Hub zur Registerkarte Sidewalk](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk), wählen Sie **Bereitstellung des Geräts** und führen Sie dann die folgenden Schritte aus, um Ihr Sidewalk-Gerät mithilfe der AWS IoT-Konsole hinzuzufügen.
![\[alt text not found\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/images/iot-sidewalk-provision-device.PNG)
1.
**Angeben der Gerätedetails**
Geben Sie die Konfigurationsinformationen für Ihr Sidewalk-Gerät an. Sie können auch ein neues Geräteprofil erstellen oder ein vorhandenes Profil für Ihr Sidewalk-Gerät auswählen.
1. Geben Sie einen Gerätenamen und optional eine Beschreibung ein. Die Beschreibung kann bis zu 2048 Zeichen lang sein. Diese Felder können nach der Erstellung des Geräts noch bearbeitet werden.
1. Wählen Sie ein Geräteprofil aus, das Sie Ihrem Sidewalk-Gerät zuordnen möchten. Wenn Sie bereits Geräteprofile haben, können Sie Ihr Profil auswählen. Wenn Sie ein neues Projekt erstellen, wählen Sie **Neues Profil erstellen** und geben Sie einen Namen für das Profil ein.
**Anmerkung**
Gehen Sie nach der Erstellung Ihres Profils zum [Profile-Hub](https://console.aws.amazon.com/iot/home#/wireless/profiles), um Ihrem Geräteprofil Tags anzuhängen, und bearbeiten Sie dann Ihr Profil, um diese Informationen hinzuzufügen.
1. Geben Sie den Namen Ihres Ziels an, das Nachrichten von Ihrem Gerät an andere AWS-Services weiterleiten soll. Wenn Sie noch kein Ziel erstellt haben, gehen Sie zum [Ziele-Hub](https://console.aws.amazon.com/iot/home#/wireless/destinations), um Ihr Ziel zu erstellen. Anschließend können Sie dieses Ziel für Ihr Sidewalk-Gerät auswählen. Weitere Informationen finden Sie unter [Hinzufügen eines Ziels zu Ihrem Sidewalk-Endgerät](iot-sidewalk-qsg-destination.md).
1. Wählen Sie **Weiter**, um mit dem Hinzufügen Ihres Sidewalk-Geräts fortzufahren.
1.
**Zuordnen des Sidewalk-Geräts zum AWS IoT-Objekt (optional)**
Sie können Ihr Sidewalk-Gerät einem AWS IoT-Objekt zuordnen. IoT-Objekte sind Einträge in der AWS IoT-Geräteregistrierung. Objekte erleichtern die Suche und Verwaltung Ihrer Geräte. Wenn Sie Ihrem Gerät ein Objekt zuordnen, kann Ihr Gerät auf andere AWS IoT Core-Features zugreifen.
Wählen Sie **Automatische Objektregistrierung**, um Ihr Gerät einem Objekt zuzuordnen.
1. Geben Sie einen eindeutigen Namen für das IoT-Objekt ein, das Sie Ihrem Sidewalk-Gerät zuordnen möchten. Bei Objektnamen wird zwischen Groß- und Kleinschreibung unterschieden. Außerdem müssen sie in Ihrem AWS-Konto und Ihrer AWS-Region eindeutig sein.
1. Stellen Sie zusätzliche Konfigurationen für Ihr IoT-Objekt bereit, z. B. die Verwendung eines Objekttyps oder durchsuchbare Attribute, die zum Filtern aus einer Objektliste verwendet werden können.
1. Wählen Sie **Weiter** und überprüfen Sie die Informationen zu Ihrem Sidewalk-Gerät. Wählen Sie dann **Erstellen**
## Hinzufügen Ihres Sidewalk-Geräts (CLI)
Führen Sie die folgenden API-Operationen aus, um Ihr Sidewalk-Gerät hinzuzufügen und die JSON-Dateien herunterzuladen, die für die Bereitstellung Ihres Sidewalk-Geräts verwendet werden.
**Topics**
+ [Schritt 1: Erstellen eines Geräteprofils](#iot-sidewalk-profile-create)
+ [Schritt 2: Hinzufügen Ihres Sidewalk-Geräts](#iot-sidewalk-device-create)
### Schritt 1: Erstellen eines Geräteprofils
Verwenden Sie die [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html)-API-Operation oder den [https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html)-CLI-Befehl, um ein Geräteprofil in Ihrem AWS-Konto zu erstellen. Wenn Sie Ihr Geräteprofil erstellen, geben Sie einen Namen und optionale Tags als Name-Wert-Paare an.
Mit dem folgenden Befehl wird beispielsweise ein Geräteprofil für Ihre Sidewalk-Gerät erstellt:
```
aws iotwireless create-device-profile \
--name sidewalk_profile --sidewalk {}
```
Wenn Sie diesen Befehl ausführen, werden der Amazon-Ressourcenname (ARN)) und die Geräteprofil-ID ausgegeben.
```
{
"DeviceProfileArn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}
```
### Schritt 2: Hinzufügen Ihres Sidewalk-Geräts
Verwenden Sie die [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html)-API-Operation oder den [https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html)-CLI-Befehl, um Ihr Sidewalk-Gerät zu Ihrem Konto für AWS IoT Core für Amazon Sidewalk hinzuzufügen. Geben Sie bei der Erstellung Ihres Geräts zusätzlich zu einem optionalen Namen und einer Beschreibung für Ihr Sidewalk-Gerät die folgenden Parameter an.
**Anmerkung**
Verwenden Sie die [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithThing.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithThing.html)-API-Operation oder den [https://docs.aws.amazon.com/cli/latest/reference/associate-wireless-device-with-thing.html](https://docs.aws.amazon.com/cli/latest/reference/associate-wireless-device-with-thing.html)-CLI-Befehl, um Ihr Sidewalk-Gerät einem AWS IoT-Objekt zuzuordnen.
Der folgende Befehl zeigt ein Beispiel für die Erstellung eines Sidewalk-Geräts:
```
aws iotwireless create-wireless-device \
--cli-input-json "file://device.json"
```
Im Folgenden werden die Inhalte der `device.json`-Datei angezeigt.
**Inhalt von device.json**
```
{
"Type": "Sidewalk",
"Name": "SidewalkDevice",
"DestinationName": "SidewalkDestination",
"Sidewalk": {
"DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}
}
```
Wenn Sie diesen Befehl ausführen, wird der Amazon-Ressourcenname (ARN)) ausgegeben.
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/23456789-abcd-0123-bcde-fabc012345678",
"Id": "23456789-abcd-0123-bcde-fabc012345678"
}
```
# Abrufen der Geräte-JSON-Dateien für die Bereitstellung
Nachdem Sie Ihr Sidewalk-Gerät zu AWS IoT Core für Amazon Sidewalk hinzugefügt haben, laden Sie die JSON-Datei mit den für die Bereitstellung Ihres Endgeräts erforderlichen Informationen herunter. Sie können diese Informationen über die AWS IoT-Konsole oder die AWS CLI abrufen. Weitere Informationen zur Bereitstellung des Geräts finden Sie unter [Bereitstellung und Registrierung Ihres Endgeräts](https://docs.sidewalk.amazon/provisioning/) in der *Dokumentation zu Amazon Sidewalk*.
## Abrufen der JSON-Datei (Konsole)
Abrufen der JSON-Datei für die Bereitstellung Ihres Sidewalk-Geräts:
1. Gehen Sie zum [Sidewalk-Geräte-Hub](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk).
1. Wählen Sie das Gerät aus, das Sie AWS IoT Core für Amazon Sidewalk hinzugefügt haben, um dessen Details anzuzeigen.
1. Rufen Sie die JSON-Datei ab, indem Sie auf der Detailseite des hinzugefügten Geräts die Option **JSON-Datei des Geräts herunterladen** auswählen.
Daraufhin wird eine `certificate.json`-Datei mit den erforderlichen Informationen für die Bereitstellung Ihres Endgeräts heruntergeladen. Nachfolgend ist ein Beispiel für eine JSON-Datei dargestellt. Sie enthält die Gerätezertifikate, private Schlüssel, die Sidewalk-Herstellungsseriennummer (SMSN) und die `DeviceTypeID`.
```
{
"p256R1": "grg8izXoVvQ86cPVm0GMyWuZYHEBbbH ... DANKkOKoNT3bUGz+/f/pyTE+xMRdIUBZ1Bw==",
"eD25519": "grg8izXoVvQ86cPVm0GMyWuZYHEBbbHD ... UiZmntHiUr1GfkTOFMYqRB+Aw==",
"metadata": {
"devicetypeid": "fe98",
"applicationDeviceArn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/897ce68e-3ca2-4ed0-85a2-30b0666c4052",
"applicationDeviceId": "897ce68e-3ca2-4ed0-85a2-30b0666c4052",
"smsn": "82B83C8B35E856F43CE9C3D59B418CC96B996071016DB1C3BE5901F0F3071A4A",
"devicePrivKeyP256R1": "3e704bf8d319b3a475179f1d68c60737b28c708f845d0198f2d00d00c88ee018",
"devicePrivKeyEd25519": "17dacb3a46ad9a42d5c520ca5f47f0167f59ce54d740aa13918465faf533b8d0"
},
"applicationServerPublicKey": "5ce29b89c2e3ce6183b41e75fe54e45f61b8bb320efbdd2abd7aefa5957a316b"
}
```
Auf der Detailseite Ihres Sidewalk-Geräts finden Sie auch folgende Informationen:
+ Die Geräte-ID, der Amazon-Ressourcenname (ARN) und Details zu allen AWS IoT-Objekten, mit denen das Gerät verknüpft ist.
+ Das Geräteprofil und die Zieldetails.
+ Der Zeitpunkt, zu dem die letzte Uplink-Nachricht vom Gerät empfangen wurde.
+ Der Status, der angibt, ob Ihr Gerät bereitgestellt oder registriert wurde.
## Abrufen der JSON-Datei (CLI)
Speichern Sie die API-Antwort auf das Abrufen von Informationen über Ihr Geräteprofil und Ihr WLAN-Gerät als JSON-Dateien, z. B. vorübergehend als *`wireless_device.json`* und *`device_profile.json`*, um die JSON-Dateien für die Bereitstellung Ihres Sidewalk-Endgeräts mithilfe der AWS IoT Core für Amazon Sidewalk-API oder der AWS CLI abzurufen. Sie werden sie für die Bereitstellung Ihres Sidewalk-Geräts benötigen.
Im Folgenden wird gezeigt, wie die JSON-Dateien abgerufen werden.
**Topics**
+ [Schritt 1: Abrufen der Geräteprofilinformationen als JSON-Datei](#iot-sidewalk-profile-get)
+ [Schritt 2: Abrufen der Sidewalk-Geräteinformationen als JSON-Datei](#iot-sidewalk-get-device)
### Schritt 1: Abrufen der Geräteprofilinformationen als JSON-Datei
Verwenden Sie die [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html)-API-Operation oder den [https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html)-CLI-Befehl, um Informationen zu Ihrem Geräteprofil abzurufen, das Sie Ihrem Konto für AWS IoT Core für Amazon Sidewalk hinzugefügt haben. Geben Sie die Profil-ID an, um Informationen zu Ihrem Geräteprofil abzurufen.
Die API gibt anschließend Informationen über das Geräteprofil zurück, das der angegebenen Kennung und der Geräte-ID entspricht. Sie speichern diese Antwortinformationen als Datei und geben ihr einen Namen wie *`device_profile.json`*.
Im Folgenden wird ein Beispiel für einen CLI-Befehl gezeigt:
```
aws iotwireless get-device-profile \
--id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" > device_profile.json
```
Wenn Sie diesen Befehl ausführen, werden die Parameter Ihres Geräteprofils, der öffentliche Schlüssel des Anwendungsservers und die `DeviceTypeID`ausgegeben. Im Folgenden wird eine JSON-Datei mit beispielhaften Antwortinformationen aus der API gezeigt. Weitere Informationen über die Parameter in der API-Antwort finden Sie unter [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html).
**`GetDeviceProfile`-API-Antwort (Inhalt von `device_profile.json`)**
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Name": "Sidewalk_profile",
"LoRaWAN": null,
"Sidewalk":
{
"ApplicationServerPublicKey": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234",
"DAKCertificateMetadata": [
{
"DeviceTypeId: "fe98",
"CertificateId": "43564A6D2D50524F544F54595045",
"FactorySupport": false,
"MaxAllowedSignature": 1000
}
],
"QualificationStatus": false
}
}
```
### Schritt 2: Abrufen der Sidewalk-Geräteinformationen als JSON-Datei
Verwenden Sie die [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html)-API-Operation oder den [https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device.html)-CLI-Befehl, um Informationen zu Ihrem Sidewalk-Gerät abzurufen, das Sie Ihrem Konto für AWS IoT Core für Amazon Sidewalk hinzugefügt haben. Geben Sie die Kennung des WLAN-Geräts an, die Sie beim Hinzufügen Ihres Geräts erhalten haben, um Informationen über Ihr Endgerät abzurufen.
Die API gibt anschließend Informationen über das Gerät aus, das der angegebenen Kennung und der Geräte-ID entspricht. Speichern Sie diese Antwortinformationen als JSON-Datei. Geben Sie der Datei einen aussagekräftigen Namen wie *`wireless_device.json`*.
Das folgende Beispiel zeigt die Ausführung des Befehls mit der CLI:
```
aws iotwireless get-wireless-device --identifier-type WirelessDeviceId \
--identifier "23456789-abcd-0123-bcde-fabc012345678" > wireless_device.json
```
Wenn Sie diesen Befehl ausführen, werden die Gerätedetails, Gerätezertifikate, private Schlüssel und die Sidewalk-Herstellungsseriennummer (SMSN) ausgegeben. Das folgende Beispiel veranschaulicht das Ergebnis der Ausführung dieses Befehls. Weitere Informationen über die Parameter in der API-Antwort finden Sie unter [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html).
**`GetWirelessDevice`-API-Antwort (Inhalt von `wireless_device.json`)**
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/23456789-abcd-0123-bcde-fabc012345678",
"Id": "23456789-abcd-0123-bcde-fabc012345678",
"DestinationName": "SidewalkDestination",
"Type": "Sidewalk",
"Sidewalk": {
"CertificateId": "4C7438772D50524F544F54595045",
"DeviceCertificates": [
{
"SigningAlg": "Ed25519",
"Value": "hDdkJw9L2uMCORjImjMHqzNR6nYYh6QKncSl5GthQNl7NKe4ounb5UMQtLjnm7zOUPYOqghCeVOLCBUiQe2ZiMBEW18JDUXIhffPobqZgohK91+LKFJ10X/F+GeltcafZcFKhS+O5NPcVNR/fHYaf/cn5iUbRwlz/T+ODXvGdwkBkgDyFgoUJgn7JdzFjaneE5qzTWXUbL79i1sXToGGjP8hiD9jJhidPWhIswleydAWgO1OZGA4CjzIaSGVM1VtaLB0VDphAkEpjMkZrtVDH3S8U1vDZTVi6YSbnkYZgfWv/uMMBfgAeL8Tdv5LkFIPIB3ZX9zt8zzmAuFRzI4MuNjWfIDnOF6AKu37WWU6/QYhZoQrW9D/wndiCcsRGl+ANn367r/HE02Re4DOiCfs9f2rjc4LT1LKt7g/KW2ii+W+9HYvvY0bBAI+AHx6Cx4j+djabTsvrgW2k6NU2zUSM7bdDP3z2a2+Z4WzBji/jYwt/OP8rpsy5Ee4ywXUfCsfQ0rKOr0zay6yh27p3I3MZle2oCO4JIlqK0VbIQqsXzSSyp6XXS0lhmuGugZ1AAADGz+gFBeX/ZNN8VJwnsNfgzj4me1HgVJdUo4W9kvx9cr2jHWkC3Oj/bdBTh1+yBjOC53yHlQK/l1GHrEWiWPPnE434LRxnWkwr8EHD4oieJxC8fkIxkQfj+gHhU79Z+oAAYAAAzsnf9SDIZPoDXF0TdC9POqTgld0oXDl2XPaVD4CvvLearrOSlFv+lsNbC4rgZn23MtIBM/7YQmJwmQ+FXRup6Tkubg1hpz04J/09dxg8UiZmntHiUr1GfkTOFMYqRB+Aw=="
},
{
"SigningAlg": "P256r1",
"Value": "hDdkJw9L2uMCORjImjMHqzNR6nYYh6QKncSl5GthQNmHmGU8a+SOqDXWwDNt3VSntpbTTQl7cMIusqweQo+JPXXWElbGh7eaxPGz4ZeF5yM2cqVNUrQr1lX/6lZ+OLuycrFrLzzB9APi0NIMLqV/Rt7XJssHQs2RPcT1ul/2XVpa6ztULJeQi2JwhTb/k48wbh/EvafG/ibrIBIx9v7/dwGRAPKHq7Uwb9hHnhpa8qNOUtjeUdIwJNh9vCBFX9s22t4PdortoFxbXo9C149PDDD4wqUHJGYlCsVX/Sqqjf7Aug3h5dwdYN6cDgsuuiOm0+aBcXBGpkh7OxVxlwXkIP+11dt23TkrSUKd0B01sc9Mc/0yEBCzx5RutKBwsefzyOl4vQX3AHgV7oD/XV73THMgGiDxQ55CPaaxN/pm791VkQ76BSZaBeF+Su6tg0k/eQneklt8Du5uqkyBHVxy8MvxsBIMZ73vIFwUrLHjDeq3+nOOyQqSBMnrHKU2mAwN3zb2LolwjPkKNOh1+NNnv99L2pBcNCnhnoBULWmWAZNXJpMx9QrcSwI9AHylcgUbGQJgf9Ryun+BgewzYNdWrXyKkp4O3ZDa4f+5SVWvbY5eyDDXcohvz/OcCtuRjAkzKBCvIjBDnCv1McjVdCO3+utizGntfhAo1RZstnOoRkgVF2WuMT9IrUmzYximuTXUmWtjyFSTqgNBZwHWUTlMmjlpLCVzZQWM4zOisXUAAALPsP34BS6EzJO5AsS5pC7QTpjBtAbLN9SdXOT9w4H1x8Nkp0ujLxWRN37IEy0V9DrPK2w1g74uqWPfUPnSBjtvM55JnQpmm23WQNvHa1Vr6zmWDjzjHpcNirPbzXyBlKEhkX4xylaSMnm4UrVXtAMaAJ/csC4HPTKr3dazdvEkhwGAAAIFByCjSp/5WHc4AhsyjMvKCsZQiKgiI8ECwjfXBaSZdY4zYsRlO3FC428H1atrFChFCZT0Bqt5LPXD38bMSB+vAUJiP8XqiEdXeqf2mYMJ5ykoDpwkve/cUQfPpjzFQlQfvwjBwiJDANKkOKoNT3bUGz+/f/pyTE+xMRdIUBZ1Bw=="
}
],
"DeviceProfileId": "0ff5b0c6-f149-4498-af34-21993acd52a7",
"PrivateKeys": [
{
"SigningAlg": "Ed25519",
"Value": "2c24d4572327f23b9bef38097137c29224a9e979081b3d90124ac9dfa477934e"
},
{
"SigningAlg": "P256r1",
"Value": "38d526f29cfaf142f596deca187bd809ef71bc13435eedc885b63bb825d63def"
}
],
"SidewalkManufacturingSn": "843764270F4BDAE3023918C89A3307AB3351EA761887A40A9DC4A5E46B6140D9",
"Status": "PROVISIONED"
},
...
}
```
## Nächste Schritte
Speichern Sie vorrübergehend die JSON-Dateien *`wireless_device.json`* und *`device_profile.json`*, da Sie sie im nächsten Schritt zur Bereitstellung und Registrierung Ihres Endgeräts für die Verbindung mit der Hardwareplattform benötigen werden. Weitere Informationen finden Sie unter [Bereitstellung und Registrierung Ihres Endgeräts](https://docs.sidewalk.amazon/provisioning/) in der *Dokumentation zu Amazon Sidewalk*.
# Hinzufügen eines Ziels zu Ihrem Sidewalk-Endgerät
Verwenden Sie AWS IoT-Regeln, um die Daten und Gerätenachrichten zu verarbeiten und an andere Services weiterzuleiten. Sie können auch Regeln definieren, um die vom Gerät empfangenen Binärnachrichten zu verarbeiten und die Nachrichten in andere Formate zu konvertieren, wodurch sie für andere Services einfacher zu verwenden sind. Ziele verknüpfen Ihre Sidewalk-Endgeräte mit der Regel, die die Gerätedaten verarbeitet, um sie an andere AWS-Service zu senden.
## Erstellen und Verwenden eines Ziels
1. Erstellen Sie eine AWS IoT-Regel und eine IAM-Rolle für das Ziel. Die AWS IoT-Regel legt die Regeln fest, nach denen die Daten des Geräts verarbeitet und zur Verwendung durch andere AWS-Service und Ihre Anwendungen weitergeleitet werden. Die IAM-Rolle gewährt Zugriff auf die Regel.
1. Erstellen Sie mithilfe der `CreateDestination`-API-Operation ein Ziel für Ihre Sidewalk-Geräte. Geben Sie den Zielnamen, den Regelnamen, den Rollennamen und optionale Parameter an. Die API gibt eine eindeutige Kennung für das Ziel zurück, das Sie beim Hinzufügen Ihres Endgerät zu AWS IoT Core für Amazon Sidewalk angeben können.
Im Folgenden wird gezeigt, wie Sie ein Ziel sowie eine AWS IoT-Regel und eine IAM-Rolle für das Ziel erstellen.
**Topics**
+ [Erstellen und Verwenden eines Ziels](#iot-sidewalk-destination-how)
+ [Hinzufügen eines Ziels für Ihr Sidewalk-Gerät](iot-sidewalk-destination-create.md)
+ [Erstellen einer IAM-Rolle und einer IoT-Regel für Ihr Ziel](sidewalk-destination-rule-role.md)
# Hinzufügen eines Ziels für Ihr Sidewalk-Gerät
Sie können Ihrem Konto für AWS IoT Core für Amazon Sidewalk entweder über den [Ziele-Hub](https://console.aws.amazon.com/iot/home#/wireless/destinations) oder über `CreateDestination` ein Ziel hinzufügen. Geben Sie bei der Erstellung Ihres Ziels Folgendes an:
+ Ein eindeutiger Name für das Ziel, den Sie für Ihr Sidewalk-Endgerät verwenden.
**Anmerkung**
Wenn Sie Ihr Gerät bereits mit einem Zielnamen hinzugefügt haben, müssen Sie diesen Namen bei der Erstellung Ihres Ziels verwenden. Weitere Informationen finden Sie unter [Schritt 2: Hinzufügen Ihres Sidewalk-Geräts](iot-sidewalk-add-device.md#iot-sidewalk-device-create).
+ Der Name der AWS IoT-Regel, die die Gerätedaten verarbeitet, und das Thema, zu dem Nachrichten veröffentlicht werden.
+ Die IAM-Rolle, die den Gerätedaten den Zugriff auf die Regel gewährt.
In den folgenden Abschnitten wird beschrieben, wie Sie eine AWS IoT-Regel und eine IAM-Rolle für Ihr Ziel erstellen.
## Erstellen eines Ziels (Konsole)
Wechseln Sie zum [Ziele-Hub](https://console.aws.amazon.com/iot/home#/wireless/destinations) und wählen Sie **Ziel hinzufügen**, um mit der AWS IoT-Konsole ein Ziel zu erstellen.
![\[alt text not found\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/images/iot-sidewalk-add-destination.PNG)
Geben Sie beim Erstellen eines Ziels die folgenden Felder an und wählen Sie dann **Ziel hinzufügen**, um die Daten eines Geräts zu verarbeiten.
+
**Zieldetails**
Geben Sie einen **Zielnamen** und eine optionale Beschreibung für Ihr Ziel ein.
+
**Regelname**
Die AWS IoT-Regel, die so konfiguriert ist, dass sie von Ihrem Gerät gesendete Nachrichten auswertet und die Gerätedaten verarbeitet. Der Regelname wird Ihrem Ziel zugeordnet. Das Ziel erfordert, dass die Regel die empfangenen Nachrichten verarbeitet. Sie können wählen, ob die Nachrichten verarbeitet werden sollen, indem Sie entweder eine AWS IoT-Regel aufrufen oder sie im AWS IoT Message Broker veröffentlichen.
+ Wenn Sie **Regelname eingeben** wählen, geben Sie einen Namen ein, und wählen Sie dann **Kopieren**, um den Regelnamen zu kopieren, den Sie bei der Erstellung der AWS IoT-Regel eingeben. Sie können entweder **Regel erstellen** wählen, um die Regel jetzt zu erstellen, oder zum [Regeln](https://console.aws.amazon.com/iot/home#/create/rule)-Hub der AWS IoT-Konsole navigieren und eine Regel mit diesem Namen erstellen.
Sie können auch eine Regel eingeben und mit der Einstellung **Erweitert** einen Themennamen angeben. Der Themenname wird beim Aufrufen der Regel angegeben und der Zugriff erfolgt mithilfe des `topic`-Ausdrucks innerhalb der Regel. Weitere Informationen über AWS IoT-Regeln finden Sie unter [AWS IoT-Regeln](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html).
+ Wenn Sie **Im AWS IoT Message Broker veröffentlichen** wählen, geben Sie einen Themennamen ein. Sie können dann den Namen des MQTT-Themas kopieren und mehrere Abonnenten können dieses Thema abonnieren, um Nachrichten zu erhalten, die zu diesem Thema veröffentlicht wurden. Weitere Informationen finden Sie unter [MQTT-Themen](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html).
Weitere Informationen zu AWS IoT-Regeln für Ziele finden Sie unter [Erstellen von Regeln zur Verarbeitung von LoRaWAN-Gerätenachrichten](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-destination-rules.html).
+
**Rollenname**
Die IAM-Rolle, die den Daten des Geräts Zugriff auf die in **Regelname** angegebene Regel gewährt. Sie können in der Konsole eine neue Servicerolle erstellen, oder eine bestehende wählen. Wenn Sie eine neue Servicerolle erstellen, können Sie entweder einen Rollennamen eingeben (z. B. **SidewalkDestinationRole**) oder das Feld leer lassen, AWS IoT Core für LoRaWAN um einen neuen Rollennamen zu generieren. AWS IoT Core für LoRaWAN erstellt anschließend automatisch die IAM-Rolle mit den entsprechenden Berechtigungen in Ihrem Namen.
## Erstellen eines Ziels (CLI)
Verwenden Sie die [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html)-API-Operation oder den [https://docs.aws.amazon.com/cli/latest/reference/create-destination.html](https://docs.aws.amazon.com/cli/latest/reference/create-destination.html)-CLI-Befehl, um ein Ziel zu erstellen. Mit dem folgenden Befehl wird beispielsweise ein Ziel für Ihr Sidewalk-Endgerät erstellt.
```
aws iotwireless create-destination --name SidewalkDestination \
--expression-type RuleName --expression SidewalkRule \
--role-arn arn:aws:iam::123456789012:role/SidewalkRole
```
Wenn Sie diesen Befehl ausführen, gibt er die Zieldetails mitsamt des Amazon-Ressourcennamens (ARN)) und des Zielnamens aus.
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/SidewalkDestination",
"Name": "SidewalkDestination"
}
```
Weitere Informationen zum Erstellen eines Ziels finden Sie unter [Erstellen von Regeln zur Verarbeitung von LoRaWAN-Gerätenachrichten](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-destination-rules.html).
# Erstellen einer IAM-Rolle und einer IoT-Regel für Ihr Ziel
AWS IoT-Regeln senden Gerätenachrichten an andere Services. AWS IoT-Regeln können auch die von einem Sidewalk-Endgerät empfangenen Binärnachrichten verarbeiten, damit sie von anderen Services verwendet werden können. AWS IoT Core für Amazon Sidewalk-Ziele verknüpfen ein WLAN-Gerät mit der Regel, die die Nachrichtendaten des Geräts verarbeitet, um sie an andere Services zu senden. Die Regel wird auf die Daten des Geräts angewendet, sobald sie von AWS IoT Core für Amazon Sidewalk empfangen werden. Für Geräte, die ihre Daten an denselben Service senden, können Sie ein Ziel erstellen, das von allen Geräten gemeinsam genutzt werden kann. Sie müssen auch eine IAM-Rolle erstellen, die die Berechtigung zum Senden von Daten an die Regel erteilt.
## Erstellen einer IAM-Rolle für Ihr Ziel
Erstellen Sie eine IAM-Rolle, die AWS IoT Core für Amazon Sidewalk die Berechtigung zum Senden von Daten an die AWS IoT-Regel erteilt. Verwenden Sie die [https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)-API-Operation oder den [https://docs.aws.amazon.com/cli/latest/reference/iam/create-role](https://docs.aws.amazon.com/cli/latest/reference/iam/create-role)-CLI-Befehl, um die Rolle zu erstellen. Sie können die Rolle *`SidewalkRole`* nennen.
```
aws iam create-role --role-name SidewalkRole \
--assume-role-policy-document '{"Version": "2012-10-17","Statement": [{ "Effect": "Allow", "Principal": {"Service": "lambda.amazonaws.com"}, "Action": "sts:AssumeRole"}]}'
```
Sie können die Vertrauensrichtlinie für die Rolle auch mithilfe einer JSON-Datei definieren.
```
aws iam create-role --role-name SidewalkRole \
--assume-role-policy-document file://trust-policy.json
```
Im Folgenden werden die Inhalte der JSON-Datei gezeigt.
**Inhalt von trust-policy.json**
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "lambda.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
## Erstellen einer Regel für Ihr Ziel
Verwenden Sie die AWS IoT Core-API-Operation [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateTopicRule.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateTopicRule.html) oder den AWS CLI-Befehl [https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html](https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html), um eine Rolle zu erstellen. Die Themenregel wird von Ihrem Ziel verwendet, um die von Ihrem Sidewalk-Endgerät empfangenen Daten an andere AWS-Services weiterzuleiten. Sie können beispielsweise eine Regelaktion erstellen, die eine Nachricht an eine Lambda-Funktion sendet. Sie können die Lambda-Funktion so definieren, dass sie die Anwendungsdaten von Ihrem Gerät empfängt und base64 verwendet, um die Nutzlastdaten zu dekodieren, sodass sie von anderen Anwendungen verwendet werden können.
In den folgenden Schritten wird gezeigt, wie Sie die Lambda-Funktion und anschließend eine Themenregel erstellen, die eine Nachricht an diese Funktion sendet.
1.
**Erstellen einer Ausführungsrolle und einer Richtlinie**
Erstellen Sie die IAM-Rolle, die Ihrer Funktion Zugriff auf AWS-Ressourcen gewährt. Sie können die Vertrauensrichtlinie für die Rolle auch mithilfe einer JSON-Datei definieren.
```
aws iam create-role --role-name lambda-ex \
--assume-role-policy-document file://lambda-trust-policy.json
```
Im Folgenden werden die Inhalte der JSON-Datei gezeigt.
**Inhalt von lambda-trust-policy.json**
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "lambda.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
1.
**Erstellen und testen der Lambda-Funktion**
Führen Sie die folgenden Schritte aus, um eine AWS Lambda-Funktion zu erstellen, die die base64-Nutzlastdaten dekodiert.
1. Schreiben Sie den Code für die Dekodierung der Nutzlastdaten. Sie können beispielsweise den folgenden Python-Beispielcode verwenden. Geben Sie einen Namen für das Skript an, z. B. *`base64_decode.py`*.
**Inhalt von base64\$1decode.py**
```
// -----------------------------------------------------------
// ----- Python script to decode incoming binary payload -----
// -----------------------------------------------------------
import json
import base64
def lambda_handler(event, context):
message = json.dumps(event)
print (message)
payload_data = base64.b64decode(event["PayloadData"])
print(payload_data)
print(int(payload_data,16))
```
1. Erstellen Sie ein Bereitstellungspaket als Zip-Datei, die die Python-Datei enthält, und nennen Sie sie `base64_decode.zip`. Verwenden Sie die `CreateFunction`-API oder den `create-function`-CLI-Befehl, um eine Lambda-Funktion für den Beispielcode *`base64_decode.py`* zu erstellen.
1.
```
aws lambda create-function --function-name my-function \
--zip-file fileb://base64_decode.zip --handler index.handler \
--runtime python3.9 --role arn:aws:iam::123456789012:role/lambda-ex
```
Die Ausgabe sollte folgendermaßen aussehen. Bei der Erstellung der Themenregel verwenden Sie den Wert des Amazon-Ressourcennamens (ARN) aus der Ausgabe `FunctionArn`.
```
{
"FunctionName": "my-function",
"FunctionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function",
"Runtime": "python3.9",
"Role": "arn:aws:iam::123456789012:role/lambda-ex",
"Handler": "index.handler",
"CodeSha256": "FpFMvUhayLkOoVBpNuNiIVML/tuGv2iJQ7t0yWVTU8c=",
"Version": "$LATEST",
"TracingConfig": {
"Mode": "PassThrough"
},
"RevisionId": "88ebe1e1-bfdf-4dc3-84de-3017268fa1ff",
...
}
```
1. Verwenden Sie die `--log-type`-Option mit dem `invoke`-Befehl, um Protokolle für einen Aufruf über die Befehlszeile abzurufen. Die Antwort enthält das Feld LogResult, das bis zu 4 KB base64-verschlüsselte Protokolle aus dem Aufruf enthält.
```
aws lambda invoke --function-name my-function out --log-type Tail
```
Sie erhalten die Antwort mit einem `StatusCode` von 200. Weitere Informationen zur Erstellung und Verwendung von Lambda-Funktionen aus AWS CLI finden Sie unter [Erstellen einer Lambda-Funktion mit der AWS CLI](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-awscli.html).
1. Erstellen einer Themenregel
Verwenden Sie die `CreateTopicRule`-API oder den `create-topic-rule`-CLI-Befehl, um eine Themenregel zu erstellen, die eine Nachricht an diese Lambda-Funktion sendet. Sie können auch eine zweite Regelaktion hinzufügen, die zu einem AWS IoT-Thema erneut veröffentlicht wird. Nennen Sie diese Themenregel `Sidewalkrule`.
```
aws iot create-topic-rule --rule-name Sidewalkrule \
--topic-rule-payload file://myrule.json
```
Sie können die `myrule.json`-Datei verwenden, um weitere Details zur Regel anzugeben. Die folgende JSON-Datei zeigt, wie Sie in einem AWS IoT-Thema erneut veröffentlichen und eine Nachricht an eine Lambda-Funktion senden.
```
{
"sql": "SELECT * ",
"actions": [
{
// You obtained this functionArn when creating the Lambda function using the
// create-function command.
"lambda": {
"functionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function"
}
},
{
// This topic can be used to observe messages exchanged between the device and
// AWS IoT Core for Amazon Sidewalk after the device is connected.
"republish": {
"roleArn": "arn:aws:iam::123456789012:role/service-role/SidewalkRepublishRole",
"topic": "project/sensor/observed"
}
}
],
}
```
# Verbinden Ihres Sidewalk-Geräts und Anzeigen des Uplink-Metadatenformats
In diesem Tutorial verwenden Sie den MQTT-Testclient, um die Konnektivität zu testen und die Nachrichten anzuzeigen, die zwischen Ihrem Endgerät und der AWS Cloud ausgetauscht werden. Abonnieren Sie im MQTT-Testclient das Thema, das Sie bei der Erstellung der IoT-Regel für Ihr Ziel angegeben haben, um Nachrichten zu empfangen. Sie können mithilfe der `SendDataToWirelessDevice`-API-Operation auch eine Downlink-Nachricht von AWS IoT Core für Amazon Sidewalk an Ihr Gerät senden. Sie können überprüfen, ob die Nachricht verschickt wurde, indem Sie die Benachrichtigung über den Nachrichtenübermittlungsstatus aktivieren.
**Anmerkung**
Informationen zum Verbinden und Einrichten Ihrer Hardwareplattform finden Sie unter [Bereitstellen und Registrieren Ihres Endgeräts](https://docs.sidewalk.amazon/provisioning/) und [Einrichten des Hardware Development Kits (HDK)](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-hdk.html) in der *Dokumentation zu Amazon Sidewalk*.
## Senden von Downlink-Nachrichten an Ihr Endgerät
Verwenden Sie die [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToWirelessDevice.html)-API-Operation oder den [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-wireless-device.html)-CLI-Befehl, um Downlink-Nachrichten von AWS IoT Core für Amazon Sidewalk an Ihr Sidewalk-Endgerät zu senden. Das folgende Beispiel veranschaulicht die Ausführung dieses Befehls. Die Nutzlastdaten sind die zu sendende Binärdatei mit base64-Verschlüsselung.
```
aws iotwireless send-data-to-wireless-device \
--id "" \
--payload-data "SGVsbG8gVG8gRGV2c2lt" \
--wireless-metadata Sidewalk={Seq=1,AckModeRetryDurationSecs=10}
```
Im Folgenden sehen Sie ein Beispiel für die Ausführung dieses Befehls. Dabei handelt es sich um eine ID der Downlink-Nachricht, die an das Gerät gesendet wurde.
```
{
MessageId: "6011dd36-0043d6eb-0072-0008"
}
```
**Anmerkung**
Die `SendDataToWirelessDevice`-API kann eine Nachrichten-ID zurückgeben, aber die Nachricht wird möglicherweise nicht erfolgreich übermittelt. Aktivieren Sie die Ereignisse zum Nachrichtenübermittlungsstatus für Ihre Sidewalk-Konten und -Geräte, um den Status der Nachricht zu überprüfen, die an das Gerät gesendet wurde. Weitere Informationen über die Aktivierung dieses Ereignisses finden Sie unter [Ereignisbenachrichtigungen für Sidewalk-Ressourcen](iot-sidewalk-events.md). Weitere Informationen zu diesem Ereignistyp finden Sie unter [Nachrichtenübermittlungsereignisse](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sidewalk-message-delivery-events.html).
## Anzeigen des Formats von Uplink-Nachrichten auf dem Gerät
Sobald Ihr Gerät verbunden ist, können Sie das Thema abonnieren (z. B. *`project/sensor/observed`*), das Sie bei der Erstellung der Zielregel angegeben haben, und sich die Uplink-Nachrichten des Geräts ansehen.
Wenn Sie bei der Erstellung Ihres Ziels einen Themennamen angegeben haben, können Sie das Thema abonnieren, um Uplink-Nachrichten von Ihrem Endgerät zu überwachen. Wechseln Sie zum [MQTT-Testclient](https://console.aws.amazon.com/iot/home#/test) auf der Seite **Test** der AWS IoT-Konsole auf, geben Sie den Themennamen ein (z. B. *`project/sensor/observed`*) und wählen Sie dann **Abonnieren**.
Das folgende Beispiel zeigt das Format der Uplink-Nachrichten, die von Sidewalk-Geräten an AWS IoT gesendet werden. Das `WirelessMetadata` enthält Metadaten zur Nachrichtenanforderung.
```
{
"PayloadData":"ZjRlNjY1ZWNlNw==",
"WirelessDeviceId":"wireless_device_id",
"WirelessMetadata":{
"Sidewalk":{
"CmdExStatus":"Cmd",
"SidewalkId":"device_id",
"Seq":0,
"MessageType":"messageType"
}
}
}
```
Die folgende Tabelle zeigt eine Definition der verschiedenen Parameter in den Uplink-Metadaten. Die `device-id` ist die ID des WLAN-Geräts, z. B. `ABCDEF1234`, und der `messageType` ist der Typ der Uplink-Nachricht, die vom Gerät empfangen wurde.
**Sidewalk-Uplink-Metadatenparameter**
| Parameter | Beschreibung | Typ | Erforderlich |
| --- | --- | --- | --- |
| PayloadData | Die Nutzlastdaten der Nachricht, die vom WLAN-Gerät gesendet wird. | String | Ja |
| WirelessDeviceID | Die Kennung des WLAN-Geräts, das die Daten sendet. | String | Ja |
| Sidewalk.CmdExStatus | Laufzeitstatus des Befehls. Nachrichten vom Typ Antwort müssen den Statuscode `COMMAND_EXEC_STATUS_SUCCESS` enthalten. Benachrichtigungen enthalten jedoch möglicherweise nicht den Statuscode. | Aufzählung | Nein |
| Sidewalk.NackExStatus | Antwortstatus der negativen Quittung, der `RADIO_TX_ERROR` oder `MEMORY_ERROR` sein kann. | Zeichenfolgen-Array | Nein |
# Massenbereitstellungsgeräte mit AWS IoT Core für Amazon Sidewalk
Sie können die Massenbereitstellung verwenden, um eine große Anzahl von Endgeräten in AWS IoT Core für Amazon Sidewalk einzugliedern. Die Massenbereitstellung ist vor allem dann nützlich, wenn Sie eine große Anzahl von Geräten in einer Fabrik herstellen und diese Geräte in AWS IoT eingliedern möchten. Weitere Informationen zur Herstellung von Geräten finden Sie unter [Herstellung von Amazon-Sidewalk-Geräten](https://docs.sidewalk.amazon/manufacturing/) in der *Dokumentation für Amazon Sidewalk*.
In den folgenden Themen wird die Massenbereitstellung veranschaulicht.
+
**[Workflow der Massenbereitstellung von Amazon Sidewalk](sidewalk-bulk-provisioning-workflow.md)**
In diesem Thema werden einige wichtige Konzepte der Massenbereitstellung und ihre Funktionsweise vorgestellt. Außerdem werden die erforderlichen Schritte beschrieben, damit Ihre Sidewalk-Geräte in AWS IoT Core für Amazon Sidewalk importiert werden können.
+
**[Erstellen von Geräteprofilen mit Werkssupport](sidewalk-provision-profile.md)**
In diesem Thema wird erläutert, wie Sie ein Geräteprofil erstellen und Unterstützung vom Werk erhalten. Sie erfahren auch, wie Sie den YubiHSM-Schlüssel beanspruchen und an Ihren Hersteller senden können, um nach der Herstellung der Geräte das Kontrollprotokoll abzurufen.
+
**[Bereitstellung von Sidewalk-Geräten mithilfe von Importaufgaben](sidewalk-provision-bulk-import.md)**
In diesem Thema erfahren Sie, wie Sie Ihre Sidewalk-Geräte massenweise bereitstellen können, indem Sie Importaufgaben erstellen und verwenden. Außerdem erfahren Sie, wie Sie Ihre Importaufgaben aktualisieren oder löschen und den Status der Importaufgabe und der Geräte in der Aufgabe einsehen können.
**Topics**
+ [Workflow der Massenbereitstellung von Amazon Sidewalk](sidewalk-bulk-provisioning-workflow.md)
+ [Erstellen von Geräteprofilen mit Werkssupport](sidewalk-provision-profile.md)
+ [Bereitstellung von Sidewalk-Geräten mithilfe von Importaufgaben](sidewalk-provision-bulk-import.md)
# Workflow der Massenbereitstellung von Amazon Sidewalk
In den folgenden Abschnitten werden die wichtigsten Konzepte der Massenbereitstellung und ihre Funktionsweise erläutert. Die erforderlichen Schritte für die Massenbereitstellung sind:
1. Erstellen Sie ein Geräteprofil mit AWS IoT Core für Amazon Sidewalk.
1. Bitten Sie das Amazon-Sidewalk-Team, Ihnen einen YubiHSM-Schlüssel zu senden und den Werkssupport in Ihrem Geräteprofil zu aktivieren.
1. Senden Sie den YubiHSM-Schlüssel an Ihren Hersteller, damit AWS IoT Core für Amazon Sidewalk das Kontrollprotokoll nach der Herstellung der Geräte abrufen kann.
1. Erstellen Sie eine Importaufgabe und geben Sie die Seriennummern (SMSN) der Geräte an, die in AWS IoT Core für Amazon Sidewalk eingegliedert werden sollen.
## Komponenten der Massenbereitstellung
Die folgenden Konzepte zeigen einige wichtige Komponenten der Massenbereitstellung und deren Einsatz im Rahmen der Massenbereitstellung Ihrer Sidewalk-Geräte.
### YubiHSM-Schlüssel
Amazon erstellt ein oder mehrere HSMs (Hardware-Sicherheitsmodule) für jedes Ihrer Sidewalk-Produkte. Jedes HSM hat eine eindeutige Seriennummer, den sogenannten YubiHSM-Schlüssel, der auf dem Hardwaremodul aufgedruckt ist. Dieser Schlüssel kann auf der [Yubico-Webseite](https://www.yubico.com/product/yubihsm-2/) erworben werden.
Der Schlüssel ist für jedes HSM einzigartig und an die einzelnen Geräteprofile gebunden, die Sie mit AWS IoT Core für Amazon Sidewalk erstellen. Wenden Sie sich an das Amazon-Sidewalk-Team, um den YubiHSM-Schlüssel anzufordern. Wenn Sie den YubiHSM-Schlüssel an den Hersteller senden, erhält AWS IoT Core für Amazon Sidewalk nach der Herstellung der Sidewalk-Geräte im Werk eine Kontrollprotokolldatei mit den Seriennummern der Geräte. Anschließend werden diese Informationen mit Ihrer CSV-Eingabedatei verglichen, um die Geräte in AWS IoT einzugliedern.
### Gerätebescheinigungsschlüssel (`DAK`)
Wenn ein Sidewalk-Endgerät in das Sidewalk-Netzwerk aufgenommen wird, muss es mit einem Sidewalk-Gerätezertifikat ausgestattet werden. Zu den für die Einrichtung Ihres Geräts verwendeten Zertifikaten gehören ein privates gerätespezifisches Zertifikat und die öffentlichen Gerätezertifikate, die der Sidewalk-Zertifikatskette entsprechen. Wenn Ihre Sidewalk-Geräte hergestellt werden, signiert das YubiHSM-Team die Gerätezertifikate.
Im Folgenden wird eine JSON-Beispieldatei gezeigt, die die Gerätezertifikate und die privaten Schlüssel enthält. Weitere Informationen finden Sie unter [Abrufen der Geräte-JSON-Dateien für die Bereitstellung](sidewalk-json-get.md).
```
{
"p256R1": "grg8izXoVvQ86cPVm0GMyWuZYHEBbbH ... DANKkOKoNT3bUGz+/f/pyTE+xMRdIUBZ1Bw==",
"eD25519": "grg8izXoVvQ86cPVm0GMyWuZYHEBbbHD ... UiZmntHiUr1GfkTOFMYqRB+Aw==",
"metadata": {
"devicetypeid": "fe98",
...
"devicePrivKeyP256R1": "3e704bf8d319b3a475179f1d68c60737b28c708f845d0198f2d00d00c88ee018",
"devicePrivKeyEd25519": "17dacb3a46ad9a42d5c520ca5f47f0167f59ce54d740aa13918465faf533b8d0"
},
"applicationServerPublicKey": "5ce29b89c2e3ce6183b41e75fe54e45f61b8bb320efbdd2abd7aefa5957a316b"
}
```
Der Gerätebescheinigungsschlüssel (DAK) ist ein privater Schlüssel, den Sie bei der Erstellung Ihres Geräteprofils erhalten. Er entspricht dem Produktzertifikat, einem eindeutigen Zertifikat, das für jedes Sidewalk-Produkt ausgestellt wird. Wenn Sie das Amazon-Sidewalk-Team kontaktieren, erhalten Sie die Sidewalk-Zertifikatskette, den YubiHSM-Schlüssel und ein HSM, das mit dem Gerätebescheinigungsschlüssel des Produkts (DAK) ausgestattet ist.
Ihr Geräteprofil wird außerdem mit dem neuen Gerätebestätigungsschlüssel (DAK) aktualisiert und der Werkssupport ist aktiviert. Die DAK-Metadateninformationen des Geräteprofils enthalten Details wie den DAK-Namen, die Zertifikat-ID, die APID (ID des angekündigten Produkts), Status des Werkssupports und die Höchstzahl der möglichen Signaturen mit dem DAK.
### ID des angekündigten Produkts (`ApId`)
Der `ApId`-Parameter ist eine alphanumerische Zeichenfolge, die das angekündigte Produkt identifiziert. Dieses Feld muss angegeben werden, wenn Sie ein bestimmtes Geräteprofil für Sidewalk-Geräte verwenden möchten, die Sie massenweise bereitstellen. AWS IoT Core für Amazon Sidewalk generiert dann den DAK und stellt ihn Ihnen über den YubiHSM-Schlüssel bereit. Die zugehörigen DAK-Informationen werden im Geräteprofil angezeigt.
Wenden Sie sich an das Amazon-Sidewalk-Supportteam, sobald Sie die Informationen über das von Ihnen erstellte Geräteprofil abgerufen haben, um den `ApId` zu erhalten. Sie können die Geräteprofilinformationen über die AWS IoT-Konsole oder mithilfe der [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html)API-Operation oder des [https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html)-CLI-Befehls abrufen.
## Funktionsweise der Massenbereitstellung
Dieses Flussdiagramm zeigt, wie die Massenbereitstellung mit AWS IoT Core für Amazon Sidewalk funktioniert.
![\[alt text not found\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/images/sidewalk-bulk-provision-flow.png)
Das folgende Verfahren veranschaulicht die verschiedenen Schritte der Massenbereitstellung.
1.
**Erstellen eines Geräteprofils für das Sidewalk-Gerät**
Bevor Sie Ihr Endgerät an das Werk schicken, erstellen Sie zunächst ein Geräteprofil. Sie können dieses Profil verwenden, um einzelne Geräte bereitzustellen, wie in [Hinzufügen Ihres Geräteprofil und Ihres Sidewalk-Endgeräts](iot-sidewalk-add-device.md) beschrieben.
1.
**Anfordern von Werkssupport für Ihr Profil**
Wenn Sie bereit sind, Ihr Endgerät an das Werk zu schicken, bitten Sie das Amazon-Sidewalk-Team um den YubiHSM-Schlüssel und Werkssupport für Ihr Geräteprofil.
1.
**Anfordern des DAK und Werkssupport für Ihr Profil**
Das Amazon-Sidewalk-Supportteam aktualisiert dann Ihr Geräteprofil mit dem Gerätebescheinigungsschlüssel (DAK) und dem Werkssupport. Ihr Geräteprofil wird automatisch mit einer ID für das angekündigte Produkt (ApID) und einem neuen DAK sowie Zertifikatsinformationen wie der Zertifikat-ID aktualisiert. Für die Massenbereitstellung eignen sich alle Sidewalk-Geräte, die dieses Profil verwenden.
1.
**Senden des YubiHSM-Schlüssels an den Hersteller (CM)**
Ihr Endgerät ist jetzt qualifiziert und Sie können Ihren YubiHSM-Schlüssel nun an den Vertragshersteller (CM) senden, um den Herstellungsprozess zu starten. Weitere Informationen finden Sie unter [Herstellen von Amazon-Sidewalk-Geräten](https://docs.sidewalk.amazon/manufacturing/) in der *Dokumentation für Amazon Sidewalk*.
1.
**Herstellen von Geräten und senden von Kontrollprotokollen und Seriennummern**
Der CM stellt die Geräte her und generiert Kontrollprotokolle. Der CM stellt Ihnen auch eine CSV-Datei zur Verfügung, die eine Liste der herzustellenden Geräte und deren Sidewalk-Herstellungsseriennummern (SMSN) enthält. Der folgende Code zeigt ein Beispiel für ein Kontrollprotokoll. Es enthält die Seriennummern des Geräts, die APID und die öffentlichen Gerätezertifikate.
```
{
"controlLogs": [
{
"version": "4-0-1",
"device":
{
"serialNumber": "device1",
"productIdentifier": {
"advertisedProductId": "abCD"
},
"sidewalkData": {
"SidewalkED25519CertificateChain": "...",
"SidewalkP256R1CertificateChain": "..."
}
}
}
]
}
```
1.
**Übergeben von Kontrollprotokollinformationen an AWS IoT Core für Amazon Sidewalk**
Die Amazon-Sidewalk-Cloud ruft die Kontrollprotokollinformationen vom Hersteller ab und leitet diese Informationen an AWS IoT Core für Amazon Sidewalk weiter. Die Geräte können dann zusammen mit ihren Seriennummern erstellt werden.
1.
**Überprüfen der Seriennummern und Starten der Massenbereitstellung**
Wenn Sie die AWS IoT-Konsole oder die AWS IoT Core für Amazon Sidewalk-API-Operation `StartWirelessDeviceImportTask` verwenden, vergleicht AWS IoT Core für Amazon Sidewalk die Sidewalk-Herstellungsseriennummer (SMSN) aller von Amazon Sidewalk bezogenen Geräte mit den entsprechenden Seriennummern in Ihrer CSV-Datei. Wenn diese Informationen übereinstimmen, wird die Massenbereitstellung gestartet und die in AWS IoT Core für Amazon Sidewalk zu importierenden Geräte werden erstellt.
# Erstellen von Geräteprofilen mit Werkssupport
Bevor Sie Ihre Amazon Sidewalk-Geräte massenweise bereitstellen können, müssen Sie ein Geräteprofil erstellen und sich dann an das Amazon Sidewalk-Supportteam wenden, um Werkssupport anzufordern. Das Amazon-Sidewalk-Team aktualisiert dann Ihr Geräteprofil mit dem Gerätebescheinigungsschlüssel (DAK) und ergänzt den Werkssupport. Sidewalk-Geräte, die dieses Profil verwenden, sind somit für die Verwendung mit AWS IoT Core für Amazon Sidewalk qualifiziert und können in die Massenbereitstellung einbezogen werden.
Nachfolgend wird beschrieben, wie Sie ein Geräteprofil mit Werkssupport erstellt wird.
1.
**Erstellen Sie eines Geräteprofils**
Erstellen Sie zunächst ein Geräteprofil. Wenn Sie ein Profil erstellen, geben Sie einen Namen und optionale Tags als Name-Wert-Paare an. Weitere Informationen zu den erforderlichen Parametern und zum Erstellen und Verwenden von Profilen finden Sie unter [Erstellen und Hinzufügen Ihres Geräts](iot-sidewalk-create-device.md#iot-sidewalk-device-how).
1.
**Anfordern von Werkssupport für das Profil**
Fordern Sie dann Werkssupport für Ihr Geräteprofil an, damit die Geräte mit diesem Profil qualifiziert werden können. Reichen Sie dazu ein Ticket beim Amazon-Sidewalk-Team ein. Nach der Bestätigung durch das Team erhalten Sie eine ApID (ID des angekündigten Produkts) und Ihr Profil wird mit einem vom Werk ausgestellten DAK aktualisiert. Sidewalk-Endgeräte mit diesem Profil werden qualifiziert.
Sie können ein Geräteprofil entweder mithilfe der AWS IoT-Konsole, den AWS IoT Core für Amazon Sidewalk-API-Operationen oder der AWS CLI erstellen.
**Topics**
+ [Erstellen eines Profils (Konsole)](#provision-profile-console)
+ [Erstellen eines Profils (CLI)](#provision-profile-cli)
+ [Nächste Schritte](#provision-profile-next)
## Erstellen eines Profils (Konsole)
Wechseln Sie zur [Registerkarte Sidewalk im Profile-Hub](https://console.aws.amazon.com/iot/home#/wireless/profiles?tab=sidewalk) und wählen Sie **Profil erstellen**, um mit der AWS IoT-Konsole ein Geräteprofil zu erstellen.
![\[alt text not found\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/images/iot-sidewalk-create-profiles.PNG)
Geben Sie die folgenden Felder an und wählen Sie dann **Absenden**, um ein Profil zu erstellen.
+
**Name**
Geben Sie einen **Namen** für Ihr Projekt ein.
+
**Tags**
Geben Sie optionale Tags als Name-Wert-Paare ein, um Ihr Profil leichter zu finden. Mithilfe von Tags können Sie außerdem Abrechnungsgebühren leichter nachverfolgen.
**Anzeigen der Profilinformationen und Qualifizieren von Profilen**
Das von Ihnen erstellte Profil wird im [Profile-Hub](https://console.aws.amazon.com/iot/home#/wireless/profiles?tab=sidewalk) angezeigt. Wählen Sie das Profil aus, um die dazugehörigen Details anzuzeigen. Darin stehen folgende Informationen:
+ Name und eindeutige Kennung des Geräteprofils sowie alle optionalen Tags, die Sie als Namen-Wert-Paare angegeben haben.
+ Der öffentliche Schlüssel des Anwendungsservers und die Gerätetyp-ID des Profils.
+ Der Qualifikationsstatus, der darauf hinweist, dass Sie ein Geräteprofil ohne Werkssupport verwenden. Um Ihr Geräteprofil für den Werkssupport zu qualifizieren, wenden Sie sich an den Amazon-Sidewalk-Support.
+ Informationen zum Gerätebescheinigungsschlüssel (DAK). Sobald Ihr Geräteprofil qualifiziert ist, wird ein neuer DAK ausgestellt und Ihr Profil wird automatisch mit den neuen DAK-Informationen aktualisiert.
## Erstellen eines Profils (CLI)
Verwenden Sie die [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html)-API-Operation oder den [https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html)-CLI-Befehl, um ein Geräteprofil zu erstellen. Mit dem folgenden Befehl wird beispielsweise ein Profil für Ihr Sidewalk-Endgerät erstellt.
```
aws iotwireless create-device-profile \
--name sidewalk_device_profile --sidewalk {}
```
Wenn Sie diesen Befehl ausführen, gibt er die Profildetails mitsamt des Amazon-Ressourcennamens (ARN)) und der Profil-ID aus.
```
{
"DeviceProfileArn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}
```
**Anzeigen der Profilinformationen und Qualifizieren von Profilen**
Verwenden Sie die [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html)-API-Operation oder den [https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html)-CLI-Befehl, um Informationen zu Ihrem Geräteprofil abzurufen, das Sie Ihrem Konto für AWS IoT Core für Amazon Sidewalk hinzugefügt haben. Geben Sie die Profil-ID an, um Informationen zu Ihrem Geräteprofil abzurufen. Die API gibt Informationen über das Geräteprofil zurück, das der angegebenen Kennung entspricht.
Im Folgenden wird ein Beispiel für einen CLI-Befehl gezeigt:
```
aws iotwireless get-device-profile \
--id "12345678-234a-45bc-67de-e8901234f0a1" > device_profile.json
```
Wenn Sie diesen Befehl ausführen, werden die Parameter Ihres Geräteprofils, der öffentliche Schlüssel des Anwendungsservers, der `DeviceTypeId`, `ApId`, der Qualifikationsstatus und die `DAKCertificate`-Informationen ausgegeben.
In diesem Beispiel weisen der Qualifikationsstatus und die DAK-Informationen darauf hin, dass Ihr Geräteprofil nicht qualifiziert ist. Wenden Sie sich an den Amazon-Sidewalk-Support, um Ihr Profil zu qualifizieren. Er stellt daraufhin einen neuen DAK ohne Geräte-Limit für Ihr Profil aus.
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Name": "Sidewalk_profile",
"LoRaWAN": null,
"Sidewalk":
{
"ApplicationServerPublicKey": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234",
"DAKCertificateMetadata": [
{
"DeviceTypeId": "fe98",
"CertificateId": "43564A6D2D50524F544F54595045",
"FactorySupport": false,
"MaxAllowedSignature": 1000
}
],
"QualificationStatus": false
}
}
```
Sobald das Amazon-Sidewalk-Supportteam diese Informationen bestätigt hat, erhalten Sie die APID und einen werksunterstützten DAK, wie im folgenden Beispiel gezeigt.
**Anmerkung**
Der `MaxAllowedSignature` von `-1` gibt an, dass für den DAK kein Geräte-Limit besteht. Informationen zu den DAK-Parametern finden Sie unter [DakCertificateMetaData](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DAKCertificateMetadata.html).
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Name": "Sidewalk_profile",
"LoRaWAN": null,
"Sidewalk":
{
"ApplicationServerPublicKey": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234",
"DAKCertificateMetadata": [
{
"ApId": "GZBd",
"CertificateId": "43564A6D2D50524F544F54595045",
"FactorySupport": true,
"MaxAllowedSignature": -1
}
],
"QualificationStatus": true
}
}
```
## Nächste Schritte
Nachdem Sie nun ein Geräteprofil mit werksunterstütztem DAK erstellt haben, geben Sie den vom Supportteam erhaltenen YubiHSM-Schlüssel an Ihren Hersteller weiter. Ihre Geräte werden dann im Werk hergestellt und anschließend werden die Kontrollprotokollinformationen mit den Seriennummern (SMSN) der Geräte an Amazon Sidewalk weitergeleitet. Weitere Informationen über diesen Workflow Sie unter [Herstellen von Amazon-Sidewalk-Geräten](https://docs.sidewalk.amazon/manufacturing/) in der *Dokumentation für Amazon Sidewalk*.
Anschließend können Sie Ihre Sidewalk-Geräte massenweise bereitstellen, indem Sie im AWS IoT Core für Amazon Sidewalk die Seriennummern der einzugliedernden Geräte angeben. Wenn AWS IoT Core für Amazon Sidewalk das Kontrollprotokoll empfängt, werden die Seriennummern im Kontrollprotokoll mit den von Ihnen angegebenen Seriennummern verglichen. Wenn die Seriennummern übereinstimmen, beginnt die Importaufgabe mit dem Onboarding Ihrer Geräte in AWS IoT Core für Amazon Sidewalk. Weitere Informationen finden Sie unter [Bereitstellung von Sidewalk-Geräten mithilfe von Importaufgaben](sidewalk-provision-bulk-import.md).
# Bereitstellung von Sidewalk-Geräten mithilfe von Importaufgaben
In diesem Abschnitt wird gezeigt, wie Sie Sidewalk-Geräte massenweise mithilfe der AWS IoT-Konsole, der AWS IoT Core für Amazon Sidewalk-API-Operationen oder der AWS CLI bereitstellen können. In den folgenden Abschnitten wird erläutert, wie Sie Ihre Sidewalk-Geräte in massenweise bereitstellen können.
**Topics**
+ [Funktionsweise der Massenbereitstellung von Sidewalk](#provision-bulk-works)
+ [Wichtige Überlegungen zur Massenbereitstellung von Sidewalk](#provision-bulk-considerations)
+ [CSV-Dateiformat](#provision-csv-format)
+ [Verwendung der Massenbereitstellung von Sidewalk](#provision-bulk-use)
+ [Massenbereitstellung von Sidewalk-Geräten](sidewalk-bulk-provision-how.md)
+ [Anzeigen der Importaufgabe und des Onboarding-Status des Geräts](sidewalk-bulk-provision-status.md)
## Funktionsweise der Massenbereitstellung von Sidewalk
Die folgenden Schritte veranschaulichen die Massenbereitstellung.
1.
**Starten einer Importaufgabe für WLAN-Geräte**
Erstellen Sie eine Importaufgabe und geben Sie die Sidewalk-Herstellungsseriennummer (SMSN) der Geräte an, die in AWS IoT Core für Amazon Sidewalk eingegliedert werden sollen, um Sidewalk-Geräte massenweise bereitzustellen. Sie haben die Sidewalk-Herstellungsseriennummer (SMSN) der Geräte als CSV-Datei in Ihrer E-Mail erhalten, nachdem der Hersteller die Kontrollprotokolle auf Amazon Sidewalk hochgeladen hat. Weitere Informationen über diesen Workflow und den Erhalt des Kontrollprotokolls finden Sie unter [Herstellen von Amazon-Sidewalk-Geräten](https://docs.sidewalk.amazon/manufacturing/) in der *Dokumentation für Amazon Sidewalk*.
1.
**Ausführen des Importvorgangs im Hintergrund**
Wenn AWS IoT Core für Amazon Sidewalk die Importaufgabenanforderung empfängt, beginnt es mit der Einrichtung und startet einen Hintergrundprozess, der das System häufig abfragt. Sobald der Hintergrundprozess die Anweisung für die Importaufgabe erhält, beginnt er mit dem Lesen der CSV-Datei. AWS IoT Core für Amazon Sidewalk prüft gleichzeitig, ob die Kontrollprotokolle von Amazon Sidewalk empfangen wurden.
1.
**Erstellen von Aufzeichnungen über WLAN-Geräte**
Wenn das Kontrollprotokoll von Amazon Sidewalk empfangen wird, überprüft AWS IoT Core für Amazon Sidewalk, ob die Seriennummern im Kontrollprotokoll mit den SMSN-Werten in der CSV-Datei übereinstimmen. Wenn die Seriennummern übereinstimmen, beginnt AWS IoT Core für Amazon Sidewalk mit der Erstellung von Datensätzen für drahtlose Geräte, die diesen Seriennummern entsprechen. Sobald alle Geräte eingegliedert wurden, wird die Importaufgabe als *Abgeschlossen* markiert.
## Wichtige Überlegungen zur Massenbereitstellung von Sidewalk
Bei der Massenbereitstellung Ihrer Sidewalk-Geräte auf AWS IoT Core für Amazon Sidewalk sollten die folgenden wichtigen Überlegungen angestellt werden.
+ Sie müssen die Massenbereitstellung mit der AWS IoT-Konsole oder dem AWS IoT Core für Amazon Sidewalk-API-Operationen in demselben AWS-Konto durchführen, in dem Sie das Geräteprofil erstellt haben.
+ Bevor Sie Ihre Sidewalk-Geräte massenweise bereitstellen, muss Ihr Geräteprofil bereits DAK-Informationen enthalten, da dies auf den Werkssupport hinweist. Andernfalls können die Massenbereitstellung über die AWS IoT-Konsole oder die API-Operationen für die Massenbereitstellung fehlschlagen.
+ Nachdem Sie eine Importaufgabe gestartet haben, kann es mindestens 10 Minuten oder länger dauern, die CSV-Datei zu verarbeiten, die WLAN-Geräte zu importieren und sie in AWS IoT Core für Amazon Sidewalk einzugliedern.
+ Die Aufgabe zum Importieren von WLAN-Geräten läuft 90 Tage nach ihrem Start ab. Während dieser Zeit wird geprüft, ob die Kontrollprotokolle von Amazon Sidewalk empfangen wurden. Wenn das Kontrollprotokoll nicht vor Ablauf dieser 90 Tage bei Amazon Sidewalk eingeht, wird die Aufgabe als *Abgeschlossen* markiert. Außerdem wird eine Meldung angezeigt, dass sie abgelaufen ist, wenn Sie sich die Aufgabendetails ansehen. Der Onboarding-Status der Geräte in der Importaufgabe, die auf das Kontrollprotokoll gewartet haben, wird als *Fehlgeschlagen* markiert.
+ Wenn Sie versuchen, eine bereits erstellte Importaufgabe zu aktualisieren, können Sie der Aufgabe nur weitere Geräte hinzufügen. Sie können jederzeit neue Geräte hinzufügen, nachdem Sie die Importaufgabe erstellt haben oder bevor die Aufgabe auf Geräten gestartet wurde, die der Importaufgabe bereits hinzugefügt wurden. Wenn die Aktualisierungsdatei Seriennummern von Geräten enthält, die bereits in der ursprünglichen Importaufgabe enthalten waren, werden diese Seriennummern ignoriert.
+ Wenn Sie eine Aktualisierung anfordern, wird davon ausgegangen, dass dieselbe IAM-Rolle, die Sie bei der Erstellung der Importaufgabe verwendet haben, für den Zugriff auf die CSV-Datei im Amazon-S3-Bucket verwendet wurde.
+ Eine Importaufgabe kann nur gelöscht werden, wenn die Aufgabe bereits abgeschlossen wurde oder wenn die Aufgabe nicht aktualisiert werden konnte. Eine Aufgabe kann möglicherweise nicht aktualisiert werden, wenn eine falsche IAM-Rolle angegeben oder eine Amazon-S3-Bucket-Datei nicht gefunden wurde. Eine Importaufgabe kann nicht aktualisiert oder gelöscht werden, wenn sie sich im `PENDING`-Status befindet.
+ Die CSV-Datei, die Sie in die Aufgabe importieren, muss das im folgenden Abschnitt beschriebene Format haben.
## CSV-Dateiformat
Die CSV-Datei, die in einem Amazon-S3-Bucket enthalten ist, den Sie für die Importaufgabe angeben, muss das folgende Format haben:
+ Zeile 1 muss das Schlüsselwort `smsn` beinhalten, das angibt, dass die importierte CSV-Datei die SMSN der zu importierenden Geräte enthält.
+ Zeile 2 und darauffolgende Zeilen müssen die SMSN der Geräte enthalten, die eingegliedert werden sollen. Die Geräte-SMSN muss das 64-Hex-Zeichenformat haben.
Diese JSON-Datei zeigt ein Beispiel für ein CSV-Dateiformat.
```
smsn
1C1A10B0AC0A200C012BBAC2CBB1B21CB12C0CA2AC1C1BB22CAA01C1B0B01122
B122C2B1121BACA2221001AC1B22012AAC11112C11C2A100C1C2B012A1100C10
02B222C110B0A210B0A0C2C112CCCAC21C1C0B0AA1221AB1022A2CC11B1B1122
C2C021CA1C111CCAB1221C0021C1C2AAA0AA1A2A01ABC10CBAACCA2A0121022A
0CB22C01BBC2CA2C0B11001121ACB2ABB0BB0121C2BA101C012CC2B20C011AC0
```
## Verwendung der Massenbereitstellung von Sidewalk
Nachfolgend wird beschrieben, wie Sie die Massenbereitstellung von Amazon Sidewalk verwenden.
1.
**Angeben der Geräteseriennummern**
Geben Sie die Seriennummern der einzugliedernden Geräte an, um Ihre Sidewalk-Geräte bereitzustellen. Sie können Ihre Geräte mit einer der folgenden Methoden bereitstellen.
+ Stellen Sie jedes Gerät einzeln mit der zugehörigen Sidewalk-Herstellungsseriennummer (SMSN) bereit. Diese Methode ist nützlich, wenn Sie den Workflow testen und Ihr Gerät schneller eingliedern möchten, ohne eine CSV-Datei mit der entsprechenden IAM-Rolle hochladen oder warten zu müssen, bis die Geräte bereit sind, um in die Aufgabe eingegliedert zu werden.
+ Stellen Sie Geräte massenweise bereit, indem Sie due URL eines Amazon-S3-Buckets angeben, die die SMSN der bereitzustellenden Geräte in einer CSV-Datei enthält. Diese Methode ist vor allem dann nützlich, wenn Sie eine große Anzahl von Geräten eingliedern möchten. In diesem Fall kann es mühsam sein, jedes Gerät einzeln einzugliedern. Stattdessen müssen Sie nur den Pfad zu der CSV-Datei, die in einen Amazon-S3-Bucket hochgeladen wurde, und die IAM-Rolle für den Zugriff auf die Datei angeben.
1.
**Abrufen der Importaufgabe und des Onboarding-Status des Geräts**
Für jede Importaufgabe, die Sie erstellen, können Sie Informationen über den Onboarding-Status der Aufgabe und der zur Aufgabe hinzugefügten Geräte abrufen. Sie können auch zusätzliche Statusinformationen anzeigen, z. B. den Grund, warum das Onboarding einer Aufgabe oder eines Geräts fehlgeschlagen ist. Weitere Informationen finden Sie unter
1.
**(Optional) Aktualisieren oder Löschen einer Importaufgabe**
Sie können eine bereits erstellte Importaufgabe aktualisieren oder löschen.
+ Sie können eine Importaufgabe jederzeit aktualisieren und der Aufgabe weitere Geräte hinzufügen, bevor die Aufgabe auf bereits hinzugefügten Geräten gestartet wurde. AWS IoT Core für Amazon Sidewalk geht von derselben IAM-Rolle aus wie jene, die Sie bei der Erstellung der Importaufgabe verwendet haben. Wenn Sie die Aufgabe erstellen, geben Sie die neue CSV-Datei an, die die Seriennummern der Geräte enthält, die Sie der Aufgabe hinzufügen möchten.
**Anmerkung**
Wenn Sie eine bestehende Importaufgabe aktualisieren, können Sie der Aufgabe nur Geräte hinzufügen. AWS IoT Core für Amazon Sidewalk führt die Geräte, die sich bereits in der Importaufgabe befinden, und die Geräte, die Sie der Aufgabe hinzufügen möchten, zusammen. Wenn die neue Datei Seriennummern von Geräten enthält, die bereits in der ursprünglichen Importaufgabe enthalten waren, werden diese Seriennummern ignoriert.
+ Sie können Importaufgaben löschen, die bereits abgeschlossen wurden oder deren Aktualisierung fehlgeschlagen ist, z. B., wenn die IAM-Rolleninformationen falsch sind oder wenn beim Erstellen oder Aktualisieren einer Aufgabe keine S3-Bucket-Datei verfügbar ist.
**Topics**
+ [Funktionsweise der Massenbereitstellung von Sidewalk](#provision-bulk-works)
+ [Wichtige Überlegungen zur Massenbereitstellung von Sidewalk](#provision-bulk-considerations)
+ [CSV-Dateiformat](#provision-csv-format)
+ [Verwendung der Massenbereitstellung von Sidewalk](#provision-bulk-use)
+ [Massenbereitstellung von Sidewalk-Geräten](sidewalk-bulk-provision-how.md)
+ [Anzeigen der Importaufgabe und des Onboarding-Status des Geräts](sidewalk-bulk-provision-status.md)
# Massenbereitstellung von Sidewalk-Geräten
In diesem Abschnitt wird gezeigt, wie Sie Sidewalk-Geräte massenweise auf AWS IoT Core für Amazon Sidewalk mithilfe der AWS IoT-Konsole oder der AWS CLI bereitstellen können.
## Massenbereitstellung von Sidewalk-Geräten (Konsole)
Wechseln Sie im [Geräte-Hub zur Registerkarte Sidewalk](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk), wählen Sie **Massenbereitstellung von Geräten** und führen Sie dann die folgenden Schritte aus, um Ihr Sidewalk-Gerät mithilfe der AWS IoT-Konsole hinzuzufügen,
![\[alt text not found\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/images/sidewalk-bulk-provision.PNG)
1.
**Auswählen der Importmethode**
Geben Sie an, auf welche Weise Sie die Geräte importieren möchten, die massenweise in AWS IoT Core für Amazon Sidewalk eingegliedert werden sollen.
+ Wählen Sie **Bereitstellung einzelner werksunterstützter Geräte**, um einzelne Geräte anhand ihrer SMSN bereitzustellen.
+ Wählen Sie **S3-Bucket verwenden**, um Geräte massenweise bereitzustellen, indem Sie eine CSV-Datei mit einer Liste von Geräten und deren SMS bereitstellen.
1.
**Geben Sie die Geräte an, die eingegliedert werden sollen**
Fügen Sie je nach der Methode, die Sie für das Onboarding Ihrer Geräte gewählt haben, die Geräteinformationen und Seriennummern hinzu.
1. Wenn Sie die Option **Bereitstellung einzelner werksunterstützter Geräte** wählen, geben Sie die folgenden Informationen an:
1. Ein **Name** für jedes Gerät, das eingegliedert werden soll. Der neue Name muss in Ihrem AWS-Konto und Ihrer AWS-Region eindeutig sein.
1. Die Sidewalk-Herstellungsseriennummer (SMSN) im Feld **SMSN eingeben**.
1. Ein **Ziel**, das die IoT-Regel beschreibt, um Nachrichten vom Gerät an andere AWS-Services weiterzuleiten.
1. Wenn Sie **S3-Bucket verwenden** ausgewählt haben:
1. Geben Sie die Informationen zum **S3-Bucket-Ziel** an, also die S3-URL-Informationen. Wählen Sie **S3 durchsuchen** und dann die gewünschte CSV-Datei, um Ihre CSV-Datei bereitzustellen.
AWS IoT Core für Amazon Sidewalk füllt automatisch die S3-URL aus, also den Pfad zu Ihrer CSV-Datei im S3-Bucket. Das Format des Pfades ist `s3://bucket_name/file_name`. Wählen Sie **Ansicht**, um die Datei in der [Amazon Simple Storage Service](https://console.aws.amazon.com/s3/)-Konsole anzuzeigen.
1. Geben Sie die **S3-Bereitstellungsrolle** an, mit der AWS IoT Core für Amazon Sidewalk für Sie die CSV-Datei im S3-Bucket aufrufen kann. Sie können entweder eine neue Servicerolle erstellen oder eine vorhandene Rolle auswählen.
Sie können einen **Rollennamen** eingeben oder das Feld leer lassen, damit automatisch ein zufälliger Name für Ihre neue Rolle generiert wird.
1. Geben Sie ein **Ziel** an, das die IoT-Regel beschreibt, um Nachrichten vom Gerät an andere AWS-Services weiterzuleiten.
1. Starten des Importvorgangs
Geben Sie alle optionalen Tags als Name-Wert-Paare an und wählen Sie **Absenden**, um die Importaufgabe für Ihr WLAN-Gerät zu starten.
## Massenbereitstellung von Sidewalk-Geräten (CLI)
Verwenden Sie eine der folgenden API-Operationen, je nachdem, ob Sie Geräte einzeln hinzufügen oder die in einem S3-Bucket enthaltene CSV-Datei bereitstellen möchten, um Ihre Sidewalk-Geräte in Ihr Konto für AWS IoT Core für Amazon Sidewalk einzubinden.
+
**Massenupload von Geräten mit einer S3-CSV-Datei**
Verwenden Sie die [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartWirelessDeviceImportTask.html)-API-Operation oder den [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-wireless-device-import-task.html) AWS CLI-Befehl, um Geräte in massenweise hochzuladen, indem Sie die CSV-Datei in einem S3-Bucket bereitstellen. Geben Sie bei der Erstellung der Aufgabe den Pfad zur CSV-Datei im Amazon-S3-Bucket und die IAM-Rolle an, die AWS IoT Core für Amazon Sidewalk Berechtigungen für den Zugriff auf die CSV-Datei gewährt.
Sobald die Aufgabe ausgeführt wird, beginnt AWS IoT Core für Amazon Sidewalk mit dem Lesen der CSV-Datei und vergleicht die Seriennummern (SMSN) in der Datei mit den entsprechenden Informationen im Kontrollprotokoll, das Sie von Amazon Sidewalk erhalten haben. Wenn die Seriennummern übereinstimmen, beginnt es mit der Erstellung von Datensätzen für WLAN-Geräte, die diesen Seriennummern entsprechen.
Der folgende Befehl zeigt ein Beispiel für die Erstellung einer Importaufgabe:
```
aws iotwireless start-wireless-device-import-task \
--cli-input-json "file://task.json"
```
Im Folgenden werden die Inhalte der `task.json`-Datei angezeigt.
**Inhalt von task.json**
```
{
"DestinationName": "Sidewalk_Destination",
"Sidewalk": {
"DeviceCreationFile": "s3://import_task_bucket/import_file1",
"Role": "arn:aws:iam::123456789012:role/service-role/ACF1zBEI"
}
}
```
Wenn Sie diesen Befehl ausführen, werden eine ID und ein ARN für die Importaufgabe ausgegeben.
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:ImportTask/a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a"
"Id": "a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a"
}
```
+
**Bereitstellen einzelner Geräte anhand ihrer SMSN**
Verwenden Sie die [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartSingleWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartSingleWirelessDeviceImportTask.html)-API-Operation oder den [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-single-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-single-wireless-device-import-task.html) AWS CLI-Befehl, um Geräte einzeln anhand ihrer SMSN bereitzustellen. Geben Sie bei der Erstellung der Aufgabe das Sidewalk-Ziel und die Seriennummer des Geräts an, das Sie eingliedern möchten.
Wenn die Seriennummer mit den entsprechenden Informationen im von Amazon Sidewalk erhaltenen Kontrollprotokoll übereinstimmt, wird die Aufgabe ausgeführt und der Datensatz für das WLAN-Gerät erstellt.
Der folgende Befehl zeigt ein Beispiel für die Erstellung einer Importaufgabe:
```
aws iotwireless start-single-wireless-device-import-task \
--destination-name sidewalk_destination \
--sidewalk '{"SidewalkManufacturingSn": "82B83C8B35E856F43CE9C3D59B418CC96B996071016DB1C3BE5901F0F3071A4A"}'
```
Wenn Sie diesen Befehl ausführen, werden eine ID und ein ARN für die Importaufgabe ausgegeben.
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:ImportTask/e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"
"Id": "e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"
}
```
## Aktualisieren oder Löschen von Importaufgaben
Wenn Sie einer Importaufgabe weitere Geräte hinzufügen möchten, können Sie die Aufgabe aktualisieren. Sie können eine Aufgabe auch löschen, wenn Sie die Aufgabe nicht mehr benötigen oder wenn sie fehlgeschlagen ist. Informationen darüber, wann eine Aufgabe aktualisiert oder gelöscht werden muss, finden Sie unter [Verwendung der Massenbereitstellung von Sidewalk](sidewalk-provision-bulk-import.md#provision-bulk-use).
**Warnung**
Löschvorgänge sind dauerhaft und können nicht rückgängig gemacht werden. Beim Löschen einer abgeschlossenen Importaufgabe werden die mithilfe der Aufgabe eingegliederten Endgeräte nicht entfernt.
Aktualisieren oder Löschen von Importaufgaben:
+
**Verwenden der AWS IoT-Konsole**
In den folgenden Schritten wird erläutert, wie Sie Ihre Importaufgaben mit der AWS IoT-Konsole aktualisieren oder löschen.
**Aktualisieren einer Importaufgabe:**
1. Gehen Sie zum [Sidewalk-Geräte-Hub](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) der AWS IoT-Konsole.
1. Wählen Sie die Importaufgabe aus, die Sie aktualisieren möchten, und wählen Sie **Bearbeiten**.
1. Stellen Sie eine weitere S3-Datei mit den Seriennummern der Geräte bereit, die Sie der Aufgabe hinzufügen möchten, und klicken Sie dann auf **Absenden**.
**Löschen einer Importaufgabe:**
1. Gehen Sie zum [Sidewalk-Geräte-Hub](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) der AWS IoT-Konsole.
1. Wählen Sie die Aufgabe, die Sie löschen möchten, und dann **Löschen**.
+
**Verwenden der AWS IoT Wireless-API oder AWS CLI**
Verwenden Sie die folgenden AWS IoT Wireless-API-Operationen oder CLI-Befehle, um Ihre Importaufgabe zu aktualisieren oder zu löschen.
+
**[https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDeviceImportTask.html)-API oder [https://docs.aws.amazon.com/cli/latest/reference/update-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/update-wireless-device-import-task.html)-CLI**
Diese API-Operation hängt den Inhalt einer Amazon-S3-CSV-Datei an eine bestehende Importaufgabe an. Sie können nur Seriennummern von Geräten hinzufügen, die zuvor nicht in der Aufgabe enthalten waren.
+
**[https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDeviceImportTask.html)-API oder [https://docs.aws.amazon.com/cli/latest/reference/delete-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/delete-wireless-device-import-task.html)-CLI**
Diese API-Operation löscht die Importaufgabe, die mithilfe der Importaufgaben-ID zum Löschen vorgemerkt wurde.
# Anzeigen der Importaufgabe und des Onboarding-Status des Geräts
Die Importaufgaben für Ihr WLAN-Gerät und Sidewalk-Geräte, die Sie der Aufgabe hinzugefügt haben, können eine der folgenden Statusmeldungen haben. Diese Meldungen werden in der AWS IoT-Konsole angezeigt oder wenn Sie eine der AWS IoT Wireless-API-Operationen oder AWS CLI-Befehle verwenden, um Informationen zu diesen Aufgaben und ihren Geräten abzurufen.
## Anzeigen von Statusinformationen zu Importaufgaben
Nachdem Sie eine Importaufgabe erstellt haben, können Sie die von Ihnen erstellte Importaufgabe und den Onboarding-Status der zur Aufgabe hinzugefügten Geräte einsehen. Der Onboarding-Status gibt die Anzahl der Geräte mit ausstehendem Onboarding, die Anzahl der eingegliederten Geräte und die Anzahl der Geräte mit fehlgeschlagenem Onboarding an.
Wenn gerade eine Importaufgabe erstellt wurde, zeigt **Anzahl ausstehend** einen Wert an, der der Anzahl der hinzugefügten Geräte entspricht. Sobald die Aufgabe gestartet und die CSV-Datei gelesen hat, um die Datensätze für die WLAN-Geräte zu erstellen, sinkt der Wert unter **Anzahl ausstehend** und die **Erfolgsanzahl** steigt, wenn Geräte erfolgreich eingegliedert werden. Wenn ein Gerät nicht eingegliedert werden kann, erhöht sich die **Anzahl fehlgeschlagener Fehler**.
Anzeigen der Importaufgabe und des Onboarding-Status des Geräts
+
**Verwenden der AWS IoT-Konsole**
Im [Sidewalk-Geräte-Hub](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) der AWS IoT-Konsole sehen Sie die von Ihnen erstellten Importaufgaben sowie die Zusammenfassung der Onboarding-Statusinformationen Ihrer Geräte. Beim Betrachten der Details einer der von Ihnen erstellten Importaufgaben können Sie zusätzliche Informationen zum Onboarding-Status des Geräts einsehen.
+
**Verwenden der AWS IoT Wireless-API oder AWS CLI**
Verwenden Sie eine der folgenden AWS IoT Wireless-API-Operationen oder den entsprechenden AWS CLI-Befehl, um den Onboarding-Status des Geräts anzuzeigen.
+
**[https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDeviceImportTasks.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDeviceImportTasks.html)-API oder [https://docs.aws.amazon.com/cli/latest/reference/list-wireless-device-import-tasks.html](https://docs.aws.amazon.com/cli/latest/reference/list-wireless-device-import-tasks.html)-CLI**
Diese API-Operation gibt Informationen zu allen Importaufgaben, die Ihrem Konto für AWS IoT Wireless hinzugefügt wurden, sowie zu deren Status aus. Außerdem wird die Anzahl der zusammengefassten Informationen zum Onboarding-Status der Sidewalk-Geräte in diesen Aufgaben angegeben.
+
**[https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDevicesForWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDevicesForWirelessDeviceImportTask.html)-API oder [https://docs.aws.amazon.com/cli/latest/reference/list-devices-for-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/list-devices-for-wireless-device-import-task.html)-CLI**
Diese API-Operation gibt Informationen über die angegebene Importaufgabe und ihren Status sowie Informationen über alle der Importaufgabe hinzugefügte Sidewalk-Geräte und deren Onboarding-Statusinformationen aus.
+
**[https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDeviceImportTask.html)-API oder [https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device-import-task.html)-CLI**
Diese API-Operation gibt Informationen über die angegebene Importaufgabe und ihren Status sowie eine Zusammenfassung des Onboarding-Status der Sidewalk-Geräte in dieser Aufgabe aus.
## Status der Importaufgabe
Die Importaufgaben, die Sie in Ihrem AWS-Konto erstellt haben, können eine der folgenden Statusmeldungen sein. Der Status gibt an, ob Ihre Importaufgabe verarbeitet wird, abgeschlossen wurde oder fehlgeschlagen ist. Sie können auch die AWS IoT-Konsole oder den `StatusReason`-Parameter einer der AWS IoT Wireless-API-Operationen verwenden, um zusätzliche Statusdetails abzurufen.
+
**WIRD INITIALISIERT**
AWS IoT Core für Amazon Sidewalk hat die Aufgabenanforderung zum Import von WLAN-Geräten erhalten und ist dabei, die Aufgabe einzurichten.
+
**INITIALISIERT**
AWS IoT Core für Amazon Sidewalk hat die Einrichtung der Importaufgabe abgeschlossen und wartet auf das Kontrollprotokoll, damit die Geräte unter Verwendung ihrer Seriennummern (SMSN) importiert und die Aufgabe weiter bearbeitet werden können.
+
**PENDING**
Die Importaufgabe wartet in der Warteschlange auf ihre Verarbeitung. AWS IoT Core für Amazon Sidewalk wertet andere Aufgaben aus, die sich in der Verarbeitungswarteschlange befinden.
+
**ABGESCHLOSSEN**
Die Importaufgabe wurde verarbeitet und abgeschlossen.
+
**FEHLGESCHLAGEN**
Die Importaufgabe oder die Geräteaufgabe ist fehlgeschlagen. Anhand des `StatusReason`-Parameters können Sie ermitteln, warum die Importaufgabe fehlgeschlagen ist, z. B. aufgrund einer Validierungsausnahme.
+
**WIRD GELÖSCHT**
Die Importaufgabe wurde zum Löschen markiert und wird gerade gelöscht.
## Onboarding-Status des Geräts
Die zu Ihrer Importaufgabe hinzugefügten Sidewalk-Geräte können eine der folgenden Statusmeldungen haben. Der Status gibt an, ob Ihre Geräte bereit für das Onboarding sind, bereits eingegliedert wurden oder nicht eingegliedert werden konnten. Sie können auch die AWS IoT-Konsole oder den `OnboardingStatusReason`-Parameter einer der AWS IoT Wireless-API-Operationen `ListDevicesForWirelessDeviceImportTask` verwenden, um zusätzliche Statusdetails abzurufen.
+
**INITIALISIERT**
AWS IoT Core für Amazon Sidewalk hat die Einrichtung der Importaufgabe abgeschlossen und wartet auf das Kontrollprotokoll, damit die Geräte unter Verwendung ihrer Seriennummern (SMSN) importiert und die Aufgabe weiter bearbeitet werden können.
+
**PENDING**
Die Importaufgabe wartet in der Warteschlange auf ihre Verarbeitung und den Beginn des Onboardings Ihrer Geräte zur Aufgabe. AWS IoT Core für Amazon Sidewalk wertet andere Aufgaben aus, die sich in der Verarbeitungswarteschlange befinden.
+
**EINGEGLIEDERT**
Das Sidewalk-Gerät wurde erfolgreich in die Importaufgabe eingegliedert.
+
**FEHLGESCHLAGEN**
Die Importaufgabe oder die Geräteaufgabe ist fehlgeschlagen, und das Sidewalk-Gerät konnte nicht in die Aufgabe eingegliedert werden. Sie können den `OnboardingStatusReason`-Parameter verwenden, um zusätzliche Informationen darüber abzurufen, warum das Onboarding des Geräts fehlgeschlagen ist.