Massenbereitstellung von Sidewalk-Geräten - AWS IoT Wireless
Massenbereitstellung von Sidewalk-Geräten (Konsole)Massenbereitstellung von Sidewalk-Geräten (CLI)Aktualisieren oder Löschen von Importaufgaben

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, 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,

  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.

  2. 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.

      2. Die Sidewalk-Herstellungsseriennummer (SMSN) im Feld SMSN eingeben.

      3. Ein Ziel, das die IoT-Regel beschreibt, um Nachrichten vom Gerät an andere AWS-Services weiterzuleiten.

    2. 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-Konsole anzuzeigen.

      2. 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.

      3. Geben Sie ein Ziel an, das die IoT-Regel beschreibt, um Nachrichten vom Gerät an andere AWS-Services weiterzuleiten.

  3. 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 StartWirelessDeviceImportTask-API-Operation oder den start-wireless-device-import-task 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 StartSingleWirelessDeviceImportTask-API-Operation oder den start-single-wireless-device-import-task 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.

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 der AWS IoT-Konsole.

    2. Wählen Sie die Importaufgabe aus, die Sie aktualisieren möchten, und wählen Sie Bearbeiten.

    3. 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 der AWS IoT-Konsole.

    2. 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.