AWS iot-wireless low security documentation change
Summary
Updated API reference links to use latest version paths and added detailed device certificate examples in wireless device response documentation
Security assessment
The change adds explicit documentation of device certificates (including Ed25519 and P256r1 signing algorithms with example values) in wireless device responses. This demonstrates authentication mechanisms for devices, which is a security-relevant implementation detail. However, there is no indication this addresses a specific vulnerability.
Diff
diff --git a/iot-wireless/latest/developerguide/iot-wireless-api-reference.md b/iot-wireless/latest/developerguide/iot-wireless-api-reference.md index 7623555b3..a5854669e 100644 --- a//iot-wireless/latest/developerguide/iot-wireless-api-reference.md +++ b//iot-wireless/latest/developerguide/iot-wireless-api-reference.md @@ -13 +13 @@ You can perform the following API operations for yourLoRaWAN and Sidewalk device - * [`CreateDeviceProfile`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html) API or the [`create-device-profile`](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-device-profile.html) CLI + * [`CreateDeviceProfile`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CreateDeviceProfile.html) API or the [`create-device-profile`](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-device-profile.html) CLI @@ -15 +15 @@ You can perform the following API operations for yourLoRaWAN and Sidewalk device - * [`GetDeviceProfile`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html) API or the [`get-device-profile`](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-device-profile.html) CLI + * [`GetDeviceProfile`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetDeviceProfile.html) API or the [`get-device-profile`](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-device-profile.html) CLI @@ -17 +17 @@ You can perform the following API operations for yourLoRaWAN and Sidewalk device - * [`ListDeviceProfiles`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDeviceProfiles.html) API or the [`list-device-profiles`](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-device-profiles.html) CLI + * [`ListDeviceProfiles`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_ListDeviceProfiles.html) API or the [`list-device-profiles`](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-device-profiles.html) CLI @@ -19 +19 @@ You can perform the following API operations for yourLoRaWAN and Sidewalk device - * [`DeleteDeviceProfile`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteDeviceProfile.html) API or the [`delete-device-profile`](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-device-profile.html) CLI + * [`DeleteDeviceProfile`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_DeleteDeviceProfile.html) API or the [`delete-device-profile`](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-device-profile.html) CLI @@ -35 +35 @@ The following sections show you how to list and delete profiles. For information -You can use the [`ListDeviceProfiles`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDeviceProfiles.html) API operation to list device profiles in your AWS account that you added to AWS IoT Wireless. You can use this information to identify the devices that you want to associate this profile to. +You can use the [`ListDeviceProfiles`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_ListDeviceProfiles.html) API operation to list device profiles in your AWS account that you added to AWS IoT Wireless. You can use this information to identify the devices that you want to associate this profile to. @@ -62 +62 @@ Running this command returns a list of device profiles that you added, including -You can delete your device profiles using the [`DeleteDeviceProfile`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteDeviceProfile.html) API operation. The following shows an example CLI command: +You can delete your device profiles using the [`DeleteDeviceProfile`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_DeleteDeviceProfile.html) API operation. The following shows an example CLI command: @@ -75 +75 @@ You can perform the following API operations for your LoRaWAN and Sidewalk devic - * [`CreateWirelessDevice`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html) API or the [`create-wireless-device`](https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html) CLI + * [`CreateWirelessDevice`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CreateWirelessDevice.html) API or the [`create-wireless-device`](https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html) CLI @@ -77 +77 @@ You can perform the following API operations for your LoRaWAN and Sidewalk devic - * [`GetWirelessDevice`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html) API or the [`get-wireless-device`](https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device.html) CLI + * [`GetWirelessDevice`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetWirelessDevice.html) API or the [`get-wireless-device`](https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device.html) CLI @@ -79 +79 @@ You can perform the following API operations for your LoRaWAN and Sidewalk devic - * [`ListWirelessDevices`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices.html) API or the [`list-wireless-devices`](https://docs.aws.amazon.com/cli/latest/reference/list-wireless-devices.html) CLI + * [`ListWirelessDevices`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_ListWirelessDevices.html) API or the [`list-wireless-devices`](https://docs.aws.amazon.com/cli/latest/reference/list-wireless-devices.html) CLI @@ -81 +81 @@ You can perform the following API operations for your LoRaWAN and Sidewalk devic - * [`DeleteWirelessDevice`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDevice.html) API or the [`delete-wireless-device`](https://docs.aws.amazon.com/cli/latest/reference/delete-wireless-device.html) CLI + * [`DeleteWirelessDevice`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_DeleteWirelessDevice.html) API or the [`delete-wireless-device`](https://docs.aws.amazon.com/cli/latest/reference/delete-wireless-device.html) CLI @@ -83 +83 @@ You can perform the following API operations for your LoRaWAN and Sidewalk devic - * [`UpdateWirelessDevice`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDevice.html) API or the [`update-wireless-device`](https://docs.aws.amazon.com/cli/latest/reference/update-wireless-device.html) CLI + * [`UpdateWirelessDevice`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_UpdateWirelessDevice.html) API or the [`update-wireless-device`](https://docs.aws.amazon.com/cli/latest/reference/update-wireless-device.html) CLI @@ -85 +85 @@ You can perform the following API operations for your LoRaWAN and Sidewalk devic - * [`AssociateWirelessDeviceWithThing`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithThing.html) API or the [`associate-wireless-device-with-thing`](https://docs.aws.amazon.com/cli/latest/reference/associate-wireless-device-with-thing.html) CLI + * [`AssociateWirelessDeviceWithThing`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_AssociateWirelessDeviceWithThing.html) API or the [`associate-wireless-device-with-thing`](https://docs.aws.amazon.com/cli/latest/reference/associate-wireless-device-with-thing.html) CLI @@ -87 +87 @@ You can perform the following API operations for your LoRaWAN and Sidewalk devic - * [`DisassociateWirelessDeviceFromThing`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DisassociateWirelessDeviceFromThing.html) API or the [`disassociate-wireless-device-from-thing`](https://docs.aws.amazon.com/cli/latest/reference/disassociate-wireless-device-from-thing.html) CLI + * [`DisassociateWirelessDeviceFromThing`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_DisassociateWirelessDeviceFromThing.html) API or the [`disassociate-wireless-device-from-thing`](https://docs.aws.amazon.com/cli/latest/reference/disassociate-wireless-device-from-thing.html) CLI @@ -105 +105 @@ To associate your LoRaWAN and Sidewalk devices with an AWS IoT thing, use the `A -Things in AWS IoT make it easier to search and manage your devices. Associating a thing with your device lets the device access other AWS IoT Core features. For more information about using this API, see [`AssociateWirelessDeviceWithThing`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithThing.html). +Things in AWS IoT make it easier to search and manage your devices. Associating a thing with your device lets the device access other AWS IoT Core features. For more information about using this API, see [`AssociateWirelessDeviceWithThing`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_AssociateWirelessDeviceWithThing.html). @@ -114 +114 @@ The following shows an example of running this command. Running this command doe -To disassociate your wireless device from an AWS IoT thing, use the [`DisassociateWirelessDeviceFromThing`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DisassociateWirelessDeviceFromThing.html) API operation, as shown in the following example. +To disassociate your wireless device from an AWS IoT thing, use the [`DisassociateWirelessDeviceFromThing`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_DisassociateWirelessDeviceFromThing.html) API operation, as shown in the following example. @@ -122 +122 @@ To disassociate your wireless device from an AWS IoT thing, use the [`Disassocia -To list wireless devices in your AWS account that you added to AWS IoT Wireless, use the [`ListWirelessDevices`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices.html) API operation. To filter the list to return only LoRaWAN or Sidewalk devices, set the `WirelessDeviceType`. +To list wireless devices in your AWS account that you added to AWS IoT Wireless, use the [`ListWirelessDevices`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_ListWirelessDevices.html) API operation. To filter the list to return only LoRaWAN or Sidewalk devices, set the `WirelessDeviceType`. @@ -129 +129 @@ The following shows an example of running this command: -Running this command returns a list of devices that you added, including their profile identifier and the Amazon Resource Name (ARN). To retrieve additional details about a specific device, use the [`GetWirelessDevice`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html) API operation. +Running this command returns a list of devices that you added, including their profile identifier and the Amazon Resource Name (ARN). To retrieve additional details about a specific device, use the [`GetWirelessDevice`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetWirelessDevice.html) API operation. @@ -138,0 +139,3 @@ Running this command returns a list of devices that you added, including their p + "LastUplinkReceivedAt": "null", + "LoRaWAN": "null", + "Positioning": "Enabled", @@ -139,0 +143 @@ Running this command returns a list of devices that you added, including their p + "AmazonId": "null", @@ -140,0 +145,36 @@ Running this command returns a list of devices that you added, including their p + "DeviceCertificates": [ + {"SigningAlg": "Ed25519", + "Value": "WUqB/E50VP7oZpHtYoBgpzJXYvhv51y/DBIfzNhrleo4UzOWCs + IzbaJwft+IPBSUQthDifJDYik0DuU1jLvuR8cpK7YyI7cUD/oZG+4Pro/s3n + AIhyXmhUlepmbveVxM8boiTiaUlL4iB9DoKrB41pWdHeg7hR8BDrE1m4sf5Q + 9ZUwDy5BqMafeW0RUKZMVunpChji0dwC5VoSSb8IT7V+bKTJXXdZ8lP11jsi + uJfwF64Eq1NCe2qKb7gql5u+qBE7vatDOSonwN56I6Ah8HWYRSyJTk7DSJKk + nSY7KGyLjs0qMI8L8AeJ++UIO/jOsGnhC6Ku1ba62bEPmIBr+889NhOngiIt + 1+1DrSOO59a1PLYqfVa5ejKq0tzzbyNG/m/oW72kkGGHRuec2zOXEO86kf4X + 0qzFfTKoo/6lt67XfXIQkO4wApCgJ8AHwHa3xz+dh+W6mFwYFRqrQQT8s0Sj + SuDtLCaqZhnch47MZk7E/itqP4JnJ7RsJHWxXsG2gTNlRghfG+zhpKzVVdvV + VZeZ22f2WZ2QoGlzXxrW0/b7mqpO2l+8fzRYYdqAp1AAADGz+gFBeX/ZNN8V + JwnsNfgzj4me1HgVJdUo4W9kvx9cr2jHWkC3Oj/bdBTh1+yBjOC53yHlQK/l1 + GHrEWiWPPnE434LRxnWkwr8EHD4oieJxC8fkIxkQfj+gHh" + }, + {"SigningAlg": "P256r1", + "Value": "WUqB/E50VP7oZpHtYoBgpzJXYvhv51y/DBIfzNhrleojbsxI2iz + y1YBsbQTzVPwYflEknYVQ1IIqMxPaRo4jSOuHX0+ixpFdnQb00YfKKmZ/Sj + 3aT4r8H6cdftGnWJlHzAcERDrJIOz8sjz11Rdp1sF+6BIeU84jQxKMXCvKGv + vJrI+qR4nke3fsN9NmgS/c2w/22599di3tf2tFBUXh+FhTAPJq64Xr8Rd4J + Z5heZYc7OPTrIi8IcSrQfq0aqnyFlogb9K2C0252s1V3ClmiRq/lWxwZTxu + UYX4XpNnFJhTNPmC+gZMHABJhBX8wX9xMd3mDJ/00F1EQKfYw8KWXuBEH4G + G0JM1k/Ve75Ql0hAmzf1wedNhSwBzwkVaat0OXcNsC++/AHhqubQ9HrC/LH + EmQ4vFCO/K0yBNY+fVOYA+pZPgAnQI9i3H4MmBNd/fONRht1TceFzFOgmUJ + ya9F1+WmWkvl9IYbfuglfkb30Yzr57Ks+/wl8wRGwVeCbqn1NaNYTPWRNTq + 7Re/8DaxVEa7MQEUhSI9rIPLuwK2rZK9mGLjThdj7wJ7AHy0vcqSgNN/nxV + JRmROMRSCdZzctV3wrfCHHUZbrfHMIp0bd9h01LijLxWj395AsS5pC7QTpj + BtAbLN9SdXOT9w4H1x8Nkp0ujLxWRN37IEy0V9DrPK2w1g74uqWPfUPnSBj + tvM55JnQpmm23WQNvHa1Vr6zmWDjzjHpcNirPbzXyBlKEhkX4xylaSMnm4U + rVXtAMaAJ/csC4HPTKr3dazdvEkhwGAAAIFByCjSp/5WHc4Ahsy" + } + ], + "DeviceProfileId": "12345678-1234-1234-1234-123456789012", + "Positioning": { + "DestinationName": "LocationDestinationName" + } @@ -149 +189 @@ Running this command returns a list of devices that you added, including their p -To delete your wireless devices, pass the `WirelessDeviceID` of the devices you want to delete to the [`DeleteWirelessDevice`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDevice.html) API operation. +To delete your wireless devices, pass the `WirelessDeviceID` of the devices you want to delete to the [`DeleteWirelessDevice`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_DeleteWirelessDevice.html) API operation. @@ -160 +200 @@ You can perform the following API operations for destinations for your LoRaWAN a - * [`CreateDestination`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html) API or the [`create-destination`](https://docs.aws.amazon.com/cli/latest/reference/create-destination.html) CLI + * [`CreateDestination`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CreateDestination.html) API or the [`create-destination`](https://docs.aws.amazon.com/cli/latest/reference/create-destination.html) CLI @@ -162 +202 @@ You can perform the following API operations for destinations for your LoRaWAN a - * [`GetDestination`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDestination.html) API or the [`get-destination`](https://docs.aws.amazon.com/cli/latest/reference/get-destination.html) CLI + * [`GetDestination`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetDestination.html) API or the [`get-destination`](https://docs.aws.amazon.com/cli/latest/reference/get-destination.html) CLI @@ -164 +204 @@ You can perform the following API operations for destinations for your LoRaWAN a - * [`UpdateDestination`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateDestination.html) API or the [`update-destination`](https://docs.aws.amazon.com/cli/latest/reference/update-destination.html) CLI + * [`UpdateDestination`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_UpdateDestination.html) API or the [`update-destination`](https://docs.aws.amazon.com/cli/latest/reference/update-destination.html) CLI @@ -166 +206 @@ You can perform the following API operations for destinations for your LoRaWAN a - * [`ListDestinations`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDestinations.html) API or the [`list-destinations`](https://docs.aws.amazon.com/cli/latest/reference/list-destinations.html) CLI + * [`ListDestinations`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_ListDestinations.html) API or the [`list-destinations`](https://docs.aws.amazon.com/cli/latest/reference/list-destinations.html) CLI @@ -168 +208 @@ You can perform the following API operations for destinations for your LoRaWAN a - * [`DeleteDestination`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteDestination.html) API or the [`delete-destination`](https://docs.aws.amazon.com/cli/latest/reference/delete-destination.html) CLI + * [`DeleteDestination`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_DeleteDestination.html) API or the [`delete-destination`](https://docs.aws.amazon.com/cli/latest/reference/delete-destination.html) CLI @@ -177 +217 @@ The following sections show you how to get, list, update, and delete destination -You can use the [`GetDestination`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDestination.html) API operation to get information about the destination that you added to your account for AWS IoT Wireless. Provide the destination name as input to the API. The API will return information about the destination matching the specified identifier. +You can use the [`GetDestination`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetDestination.html) API operation to get information about the destination that you added to your account for AWS IoT Wireless. Provide the destination name as input to the API. The API will return information about the destination matching the specified identifier. @@ -197 +237 @@ Running this command returns the parameters of your destination. -Use the [`UpdateDestination`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateDestination.html) API operation to update properties of your destination that you added to your account for AWS IoT Wireless. The following shows an example CLI command that updates the description property: +Use the [`UpdateDestination`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_UpdateDestination.html) API operation to update properties of your destination that you added to your account for AWS IoT Wireless. The following shows an example CLI command that updates the description property: @@ -205 +245 @@ Use the [`UpdateDestination`](https://docs.aws.amazon.com/iot-wireless/2020-11-2 -Use the [`ListDestinations`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDestinations.html) API operation to list destinations in your AWS account that you added to AWS IoT Wireless. To filter the list to return only destinations for LoRaWAN and Sidewalk end devices, use the `WirelessDeviceType` parameter. +Use the [`ListDestinations`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_ListDestinations.html) API operation to list destinations in your AWS account that you added to AWS IoT Wireless. To filter the list to return only destinations for LoRaWAN and Sidewalk end devices, use the `WirelessDeviceType` parameter. @@ -235 +275 @@ Running this command returns a list of destinations that you added, including th -To delete your destination, pass the name of the destination to be deleted as input to the [`DeleteDestination`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteDestination.html) API operation. The following shows an example CLI command: +To delete your destination, pass the name of the destination to be deleted as input to the [`DeleteDestination`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_DeleteDestination.html) API operation. The following shows an example CLI command: @@ -248 +288 @@ You can perform the following API operations for bulk provisioning your Sidewalk - * [`StartWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartWirelessDeviceImportTask.html) API or the [`start-wireless-device-import-task`](https://docs.aws.amazon.com/cli/latest/reference/start-wireless-device-import-task.html) CLI + * [`StartWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_StartWirelessDeviceImportTask.html) API or the [`start-wireless-device-import-task`](https://docs.aws.amazon.com/cli/latest/reference/start-wireless-device-import-task.html) CLI @@ -250 +290 @@ You can perform the following API operations for bulk provisioning your Sidewalk - * [`StartSingleWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartSingleWirelessDeviceImportTask.html) API or the [`start-single-wireless-device-import-task`](https://docs.aws.amazon.com/cli/latest/reference/start-single-wireless-device-import-task.html) CLI + * [`StartSingleWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_StartSingleWirelessDeviceImportTask.html) API or the [`start-single-wireless-device-import-task`](https://docs.aws.amazon.com/cli/latest/reference/start-single-wireless-device-import-task.html) CLI @@ -252 +292 @@ You can perform the following API operations for bulk provisioning your Sidewalk - * [`ListWirelessDeviceImportTasks`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDeviceImportTasks.html) API or the [`list-wireless-device-import-tasks`](https://docs.aws.amazon.com/cli/latest/reference/list-wireless-device-import-tasks.html) CLI + * [`ListWirelessDeviceImportTasks`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_ListWirelessDeviceImportTasks.html) API or the [`list-wireless-device-import-tasks`](https://docs.aws.amazon.com/cli/latest/reference/list-wireless-device-import-tasks.html) CLI @@ -254 +294 @@ You can perform the following API operations for bulk provisioning your Sidewalk - * [`ListDevicesForWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDevicesForWirelessDeviceImportTask.html) API or the [`list-devices-for-wireless-device-import-task`](https://docs.aws.amazon.com/cli/latest/reference/list-devices-for-wireless-device-import-task.html) CLI + * [`ListDevicesForWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_ListDevicesForWirelessDeviceImportTask.html) API or the [`list-devices-for-wireless-device-import-task`](https://docs.aws.amazon.com/cli/latest/reference/list-devices-for-wireless-device-import-task.html) CLI @@ -256 +296 @@ You can perform the following API operations for bulk provisioning your Sidewalk - * [`GetWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDeviceImportTask.html) API or the [`get-wireless-device-import-task`](https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device-import-task.html) CLI + * [`GetWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetWirelessDeviceImportTask.html) API or the [`get-wireless-device-import-task`](https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device-import-task.html) CLI @@ -258 +298 @@ You can perform the following API operations for bulk provisioning your Sidewalk - * [`UpdateWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDeviceImportTask.html) API or the [`update-wireless-device-import-task`](https://docs.aws.amazon.com/cli/latest/reference/update-wireless-device-import-task.html) CLI + * [`UpdateWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_UpdateWirelessDeviceImportTask.html) API or the [`update-wireless-device-import-task`](https://docs.aws.amazon.com/cli/latest/reference/update-wireless-device-import-task.html) CLI @@ -260 +300 @@ You can perform the following API operations for bulk provisioning your Sidewalk - * [`DeleteWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDeviceImportTask.html) API or the [`delete-wireless-device-import-task`](https://docs.aws.amazon.com/cli/latest/reference/delete-wireless-device-import-task.html) CLI + * [`DeleteWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_DeleteWirelessDeviceImportTask.html) API or the [`delete-wireless-device-import-task`](https://docs.aws.amazon.com/cli/latest/reference/delete-wireless-device-import-task.html) CLI @@ -269 +309 @@ The following sections show you how to get, list, update, and delete import task -You can use the [`ListDevicesForWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDevicesForWirelessDeviceImportTask.html) API operation to retrieve information about a particular import task and the onboarding status of devices in that task. As input to the API operation, specify the import task ID that you obtained from either the `StartWirelessDeviceImportTask` or `StartSingleWirelessDeviceImportTask` API operations. The API will then return information about the import task matching the specified identifier. +You can use the [`ListDevicesForWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_ListDevicesForWirelessDeviceImportTask.html) API operation to retrieve information about a particular import task and the onboarding status of devices in that task. As input to the API operation, specify the import task ID that you obtained from either the `StartWirelessDeviceImportTask` or `StartSingleWirelessDeviceImportTask` API operations. The API will then return information about the import task matching the specified identifier. @@ -282,0 +323 @@ Running this command returns your import task information and device onboarding + "LoRaWAN": "null", @@ -284,0 +326 @@ Running this command returns your import task information and device onboarding + "OnboardingStatusReason":"null", @@ -286,0 +329 @@ Running this command returns your import task information and device onboarding + } @@ -287,0 +331,2 @@ Running this command returns your import task information and device onboarding + { + "LoRaWAN": "null", @@ -289,0 +335 @@ Running this command returns your import task information and device onboarding + "OnboardingStatusReason":"null", @@ -292 +337,0 @@ Running this command returns your import task information and device onboarding - }, @@ -294 +339,9 @@ Running this command returns your import task information and device onboarding - ] + } + ], + "NextToken": "null", + "Positioning": "Enabled", + "Sidewalk": { + Positioning": { + "DestinationName": "SidewalkLocationDestination" + } + } @@ -299 +352 @@ Running this command returns your import task information and device onboarding -To get a count of summary information of the onboarding status of devices that you added to a particular import task, use the [`GetWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDeviceImportTask.html) API operation. The following shows an example CLI command. +To get a count of summary information of the onboarding status of devices that you added to a particular import task, use the [`GetWirelessDeviceImportTask`](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetWirelessDeviceImportTask.html) API operation. The following shows an example CLI command. @@ -308,3 +361,21 @@ The following code shows a sample response from the command. - "NumberOfFailedImportedDevices": 2, - "NumberOfOnboardedImportedDevices": 4, - "NumberOfPendingImportedDevices": 1 + + "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ImportTask + /12345678-1234-5678-1234-123456789012", + "CreationTime": "2025-09-17T22:13:57.306Z", + "DestinationName": "DestinationTest", + "FailedImportedDeviceCount": "1", + "Id": "12345678-1234-5678-1234-123456789012", + "InitializedImportedDeviceCount": "0", + "LoRaWAN": null, + "OnboardedImportedDeviceCount": "0", + "PendingImportedDeviceCount": "0", + "Positioning": "null", + "Sidewalk": { + "DeviceCreationFileList": "[]", + "Positioning": { + "DestinationName": "null" + },