AWS IoT Wireless-API-Operationen für LoRaWAN- und Sidewalk-Geräte
Sie können folgende API-Operationen für Ihre LoRaWAN- und Sidewalk-Geräte ausführen:
-
CreateWirelessDevice-API oder diecreate-wireless-device-CLI -
GetWirelessDevice-API oder dieget-wireless-device-CLI -
ListWirelessDevices-API oder dielist-wireless-devices-CLI -
DeleteWirelessDevice-API oder diedelete-wireless-device-CLI -
UpdateWirelessDevice-API oder dieupdate-wireless-device-CLI -
AssociateWirelessDeviceWithThing-API oder dieassociate-wireless-device-with-thing-CLI -
DisassociateWirelessDeviceFromThing-API oder diedisassociate-wireless-device-from-thing-CLI
In den folgenden Abschnitten wird gezeigt, wie Geräte aufgelistet und gelöscht werden. Informationen zum Erstellen von drahtlosen Geräten und zum Abrufen von Geräteinformationen finden Sie unter:
Zuordnen von drahtlosen Geräten zu einem IoT-Objekt in Ihrem AWS-Konto
Verwenden Sie die AssociateWirelessDeviceWithThing-API-Operation, um Ihre LoRaWAN- und Sidewalk-Geräte einem AWS IoT-Objekt zuzuordnen.
Die Objekte in AWS IoT erleichtern die Suche und Verwaltung Ihrer Geräte. Wenn Sie Ihrem Gerät ein Objekt zuordnen, kann das Gerät auf andere AWS IoT Core-Funktionen zugreifen. Weitere Informationen zur Verwendung dieser API finden Sie unter AssociateWirelessDeviceWithThing.
Das folgende Beispiel veranschaulicht die Ausführung dieses Befehls. Dieser Befehl liefert keine Ausgabe.
aws iotwireless associate-wireless-device-with-thing \ --id"12345678-a1b2-3c45-67d8-e90fa1b2c34d"\ --thing-arn "arn:aws:iot:us-east-1:123456789012:thing/MySidewalkThing"
Verwenden Sie die DisassociateWirelessDeviceFromThing-API-Operation, wie im folgenden Beispiel gezeigt, um Ihr drahtloses Gerät von einem AWS IoT-Objekt zu trennen.
aws iotwireless disassociate-wireless-device-from-thing \ --id"12345678-a1b2-3c45-67d8-e90fa1b2c34d"
Auflisten von drahtlosen Geräten in Ihrem AWS-Konto
Sie können die ListWirelessDevices-API-Operation verwenden, um drahtlose Geräte in Ihrem AWS-Konto aufzulisten, die Sie AWS IoT Wireless hinzugefügt haben. Legen Sie den WirelessDeviceType fest, um die Liste so zu filtern, dass nur LoRaWAN- oder Sidewalk-Geräte angezeigt werden.
Das folgende Beispiel veranschaulicht die Ausführung dieses Befehls:
aws iotwireless list-wireless-devices --wireless-device-type Sidewalk
Wenn Sie diesen Befehl ausführen, wird eine Liste der von Ihnen hinzugefügten Geräte ausgegeben, einschließlich ihrer Profil-ID und des Amazon-Ressourcennamens (ARN). Verwenden Sie die GetWirelessDevice-API-Operation, um zusätzliche Details zu einem bestimmten Gerät abzurufen.
{ "WirelessDeviceList": [ { "Name": "mySidewalkDevice", "DestinationName": "SidewalkDestination", "Id": "1ffd32c8-8130-4194-96df-622f072a315f", "Type": "Sidewalk", "Sidewalk": { "SidewalkId": "1234567890123456" }, "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/1ffd32c8-8130-4194-96df-622f072a315f" } ] }
Löschen von drahtlosen Geräten aus Ihrem AWS-Konto
Um Ihre drahtlosen Geräte zu löschen, übergeben Sie die WirelessDeviceID der Geräte, die Sie löschen möchten, an die DeleteWirelessDevice-API-Operation.
Im Folgenden wird ein Beispielbefehl gezeigt:
aws iotwireless delete-wireless-device --id "23456789-abcd-0123-bcde-fabc012345678"
Dieser Befehl liefert keine Ausgabe. Sie können die GetWirelessDevice-API oder die ListWirelessDevices-API-Operation verwenden, um zu überprüfen, ob das Gerät aus Ihrem Konto entfernt wurde.