AWS IoT Wireless

2025/11/13 - AWS IoT Wireless - 9 updated api methods

Changes  Integration of Device Location with Amazon Sidewalk network for Amazon Sidewalk enabled devices

CreateWirelessDevice (updated) Link ¶
Changes (request)
{'Sidewalk': {'Positioning': {'DestinationName': 'string'},
              'SidewalkManufacturingSn': 'string'}}

Provisions a wireless device.

See also: AWS API Documentation

Request Syntax

client.create_wireless_device(
    Type='Sidewalk'|'LoRaWAN',
    Name='string',
    Description='string',
    DestinationName='string',
    ClientRequestToken='string',
    LoRaWAN={
        'DevEui': 'string',
        'DeviceProfileId': 'string',
        'ServiceProfileId': 'string',
        'OtaaV1_1': {
            'AppKey': 'string',
            'NwkKey': 'string',
            'JoinEui': 'string'
        },
        'OtaaV1_0_x': {
            'AppKey': 'string',
            'AppEui': 'string',
            'JoinEui': 'string',
            'GenAppKey': 'string'
        },
        'AbpV1_1': {
            'DevAddr': 'string',
            'SessionKeys': {
                'FNwkSIntKey': 'string',
                'SNwkSIntKey': 'string',
                'NwkSEncKey': 'string',
                'AppSKey': 'string'
            },
            'FCntStart': 123
        },
        'AbpV1_0_x': {
            'DevAddr': 'string',
            'SessionKeys': {
                'NwkSKey': 'string',
                'AppSKey': 'string'
            },
            'FCntStart': 123
        },
        'FPorts': {
            'Fuota': 123,
            'Multicast': 123,
            'ClockSync': 123,
            'Positioning': {
                'ClockSync': 123,
                'Stream': 123,
                'Gnss': 123
            },
            'Applications': [
                {
                    'FPort': 123,
                    'Type': 'SemtechGeolocation',
                    'DestinationName': 'string'
                },
            ]
        }
    },
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    Positioning='Enabled'|'Disabled',
    Sidewalk={
        'DeviceProfileId': 'string',
        'Positioning': {
            'DestinationName': 'string'
        },
        'SidewalkManufacturingSn': 'string'
    }
)
type Type:

string

param Type:

[REQUIRED]

The wireless device type.

type Name:

string

param Name:

The name of the new resource.

type Description:

string

param Description:

The description of the new resource.

type DestinationName:

string

param DestinationName:

[REQUIRED]

The name of the destination to assign to the new wireless device.

type ClientRequestToken:

string

param ClientRequestToken:

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

This field is autopopulated if not provided.

type LoRaWAN:

dict

param LoRaWAN:

The device configuration information to use to create the wireless device.

  • DevEui (string) --

    The DevEUI value.

  • DeviceProfileId (string) --

    The ID of the device profile for the new wireless device.

  • ServiceProfileId (string) --

    The ID of the service profile.

  • OtaaV1_1 (dict) --

    OTAA device object for v1.1 for create APIs

    • AppKey (string) --

      The AppKey value.

    • NwkKey (string) --

      The NwkKey value.

    • JoinEui (string) --

      The JoinEUI value.

  • OtaaV1_0_x (dict) --

    OTAA device object for create APIs for v1.0.x

    • AppKey (string) --

      The AppKey value.

    • AppEui (string) --

      The AppEUI value. You specify this value when using LoRaWAN versions v1.0.2 or v1.0.3.

    • JoinEui (string) --

      The JoinEUI value. You specify this value instead of the AppEUI when using LoRaWAN version v1.0.4.

    • GenAppKey (string) --

      The GenAppKey value.

  • AbpV1_1 (dict) --

    ABP device object for create APIs for v1.1

    • DevAddr (string) --

      The DevAddr value.

    • SessionKeys (dict) --

      Session keys for ABP v1.1

      • FNwkSIntKey (string) --

        The FNwkSIntKey value.

      • SNwkSIntKey (string) --

        The SNwkSIntKey value.

      • NwkSEncKey (string) --

        The NwkSEncKey value.

      • AppSKey (string) --

        The AppSKey value.

    • FCntStart (integer) --

      The FCnt init value.

  • AbpV1_0_x (dict) --

    LoRaWAN object for create APIs

    • DevAddr (string) --

      The DevAddr value.

    • SessionKeys (dict) --

      Session keys for ABP v1.0.x

      • NwkSKey (string) --

        The NwkSKey value.

      • AppSKey (string) --

        The AppSKey value.

    • FCntStart (integer) --

      The FCnt init value.

  • FPorts (dict) --

    List of FPort assigned for different LoRaWAN application packages to use

    • Fuota (integer) --

      The Fport value.

    • Multicast (integer) --

      The Fport value.

    • ClockSync (integer) --

      The Fport value.

    • Positioning (dict) --

      FPort values for the GNSS, stream, and ClockSync functions of the positioning information.

      • ClockSync (integer) --

        The Fport value.

      • Stream (integer) --

        The Fport value.

      • Gnss (integer) --

        The Fport value.

    • Applications (list) --

      Optional LoRaWAN application information, which can be used for geolocation.

      • (dict) --

        LoRaWAN application configuration, which can be used to perform geolocation.

        • FPort (integer) --

          The Fport value.

        • Type (string) --

          Application type, which can be specified to obtain real-time position information of your LoRaWAN device.

        • DestinationName (string) --

          The name of the position data destination that describes the AWS IoT rule that processes the device's position data for use by AWS IoT Core for LoRaWAN.

type Tags:

list

param Tags:

The tags to attach to the new wireless device. Tags are metadata that you can use to manage a resource.

  • (dict) --

    A simple label consisting of a customer-defined key-value pair

    • Key (string) -- [REQUIRED]

      The tag's key value.

    • Value (string) -- [REQUIRED]

      The tag's value.

type Positioning:

string

param Positioning:

The integration status of the Device Location feature for LoRaWAN and Sidewalk devices.

type Sidewalk:

dict

param Sidewalk:

The device configuration information to use to create the Sidewalk device.

  • DeviceProfileId (string) --

    The ID of the Sidewalk device profile.

  • Positioning (dict) --

    The Positioning object of the Sidewalk device.

    • DestinationName (string) --

      The location destination name of the Sidewalk device.

  • SidewalkManufacturingSn (string) --

    The Sidewalk manufacturing serial number.

rtype:

dict

returns:

Response Syntax

{
    'Arn': 'string',
    'Id': 'string'
}

Response Structure

  • (dict) --

    • Arn (string) --

      The Amazon Resource Name of the new resource.

    • Id (string) --

      The ID of the new wireless device.

GetWirelessDevice (updated) Link ¶
Changes (response)
{'Sidewalk': {'Positioning': {'DestinationName': 'string'}}}

Gets information about a wireless device.

See also: AWS API Documentation

Request Syntax

client.get_wireless_device(
    Identifier='string',
    IdentifierType='WirelessDeviceId'|'DevEui'|'ThingName'|'SidewalkManufacturingSn'
)
type Identifier:

string

param Identifier:

[REQUIRED]

The identifier of the wireless device to get.

type IdentifierType:

string

param IdentifierType:

[REQUIRED]

The type of identifier used in identifier.

rtype:

dict

returns:

Response Syntax

{
    'Type': 'Sidewalk'|'LoRaWAN',
    'Name': 'string',
    'Description': 'string',
    'DestinationName': 'string',
    'Id': 'string',
    'Arn': 'string',
    'ThingName': 'string',
    'ThingArn': 'string',
    'LoRaWAN': {
        'DevEui': 'string',
        'DeviceProfileId': 'string',
        'ServiceProfileId': 'string',
        'OtaaV1_1': {
            'AppKey': 'string',
            'NwkKey': 'string',
            'JoinEui': 'string'
        },
        'OtaaV1_0_x': {
            'AppKey': 'string',
            'AppEui': 'string',
            'JoinEui': 'string',
            'GenAppKey': 'string'
        },
        'AbpV1_1': {
            'DevAddr': 'string',
            'SessionKeys': {
                'FNwkSIntKey': 'string',
                'SNwkSIntKey': 'string',
                'NwkSEncKey': 'string',
                'AppSKey': 'string'
            },
            'FCntStart': 123
        },
        'AbpV1_0_x': {
            'DevAddr': 'string',
            'SessionKeys': {
                'NwkSKey': 'string',
                'AppSKey': 'string'
            },
            'FCntStart': 123
        },
        'FPorts': {
            'Fuota': 123,
            'Multicast': 123,
            'ClockSync': 123,
            'Positioning': {
                'ClockSync': 123,
                'Stream': 123,
                'Gnss': 123
            },
            'Applications': [
                {
                    'FPort': 123,
                    'Type': 'SemtechGeolocation',
                    'DestinationName': 'string'
                },
            ]
        }
    },
    'Sidewalk': {
        'AmazonId': 'string',
        'SidewalkId': 'string',
        'SidewalkManufacturingSn': 'string',
        'DeviceCertificates': [
            {
                'SigningAlg': 'Ed25519'|'P256r1',
                'Value': 'string'
            },
        ],
        'PrivateKeys': [
            {
                'SigningAlg': 'Ed25519'|'P256r1',
                'Value': 'string'
            },
        ],
        'DeviceProfileId': 'string',
        'CertificateId': 'string',
        'Status': 'PROVISIONED'|'REGISTERED'|'ACTIVATED'|'UNKNOWN',
        'Positioning': {
            'DestinationName': 'string'
        }
    },
    'Positioning': 'Enabled'|'Disabled'
}

Response Structure

  • (dict) --

    • Type (string) --

      The wireless device type.

    • Name (string) --

      The name of the resource.

    • Description (string) --

      The description of the resource.

    • DestinationName (string) --

      The name of the destination to which the device is assigned.

    • Id (string) --

      The ID of the wireless device.

    • Arn (string) --

      The Amazon Resource Name of the resource.

    • ThingName (string) --

      The name of the thing associated with the wireless device. The value is empty if a thing isn't associated with the device.

    • ThingArn (string) --

      The ARN of the thing associated with the wireless device.

    • LoRaWAN (dict) --

      Information about the wireless device.

      • DevEui (string) --

        The DevEUI value.

      • DeviceProfileId (string) --

        The ID of the device profile for the new wireless device.

      • ServiceProfileId (string) --

        The ID of the service profile.

      • OtaaV1_1 (dict) --

        OTAA device object for v1.1 for create APIs

        • AppKey (string) --

          The AppKey value.

        • NwkKey (string) --

          The NwkKey value.

        • JoinEui (string) --

          The JoinEUI value.

      • OtaaV1_0_x (dict) --

        OTAA device object for create APIs for v1.0.x

        • AppKey (string) --

          The AppKey value.

        • AppEui (string) --

          The AppEUI value. You specify this value when using LoRaWAN versions v1.0.2 or v1.0.3.

        • JoinEui (string) --

          The JoinEUI value. You specify this value instead of the AppEUI when using LoRaWAN version v1.0.4.

        • GenAppKey (string) --

          The GenAppKey value.

      • AbpV1_1 (dict) --

        ABP device object for create APIs for v1.1

        • DevAddr (string) --

          The DevAddr value.

        • SessionKeys (dict) --

          Session keys for ABP v1.1

          • FNwkSIntKey (string) --

            The FNwkSIntKey value.

          • SNwkSIntKey (string) --

            The SNwkSIntKey value.

          • NwkSEncKey (string) --

            The NwkSEncKey value.

          • AppSKey (string) --

            The AppSKey value.

        • FCntStart (integer) --

          The FCnt init value.

      • AbpV1_0_x (dict) --

        LoRaWAN object for create APIs

        • DevAddr (string) --

          The DevAddr value.

        • SessionKeys (dict) --

          Session keys for ABP v1.0.x

          • NwkSKey (string) --

            The NwkSKey value.

          • AppSKey (string) --

            The AppSKey value.

        • FCntStart (integer) --

          The FCnt init value.

      • FPorts (dict) --

        List of FPort assigned for different LoRaWAN application packages to use

        • Fuota (integer) --

          The Fport value.

        • Multicast (integer) --

          The Fport value.

        • ClockSync (integer) --

          The Fport value.

        • Positioning (dict) --

          FPort values for the GNSS, stream, and ClockSync functions of the positioning information.

          • ClockSync (integer) --

            The Fport value.

          • Stream (integer) --

            The Fport value.

          • Gnss (integer) --

            The Fport value.

        • Applications (list) --

          Optional LoRaWAN application information, which can be used for geolocation.

          • (dict) --

            LoRaWAN application configuration, which can be used to perform geolocation.

            • FPort (integer) --

              The Fport value.

            • Type (string) --

              Application type, which can be specified to obtain real-time position information of your LoRaWAN device.

            • DestinationName (string) --

              The name of the position data destination that describes the AWS IoT rule that processes the device's position data for use by AWS IoT Core for LoRaWAN.

    • Sidewalk (dict) --

      Sidewalk device object.

      • AmazonId (string) --

        The Sidewalk Amazon ID.

      • SidewalkId (string) --

        The sidewalk device identification.

      • SidewalkManufacturingSn (string) --

        The Sidewalk manufacturing series number.

      • DeviceCertificates (list) --

        The sidewalk device certificates for Ed25519 and P256r1.

        • (dict) --

          List of sidewalk certificates.

          • SigningAlg (string) --

            The certificate chain algorithm provided by sidewalk.

          • Value (string) --

            The value of the chosen sidewalk certificate.

      • PrivateKeys (list) --

        The Sidewalk device private keys that will be used for onboarding the device.

        • (dict) --

          List of sidewalk certificates.

          • SigningAlg (string) --

            The certificate chain algorithm provided by sidewalk.

          • Value (string) --

            The value of the chosen sidewalk certificate.

      • DeviceProfileId (string) --

        The ID of the Sidewalk device profile.

      • CertificateId (string) --

        The ID of the Sidewalk device profile.

      • Status (string) --

        The Sidewalk device status, such as provisioned or registered.

      • Positioning (dict) --

        The Positioning object of the Sidewalk device.

        • DestinationName (string) --

          The location destination name of the Sidewalk device.

    • Positioning (string) --

      The integration status of the Device Location feature for LoRaWAN and Sidewalk devices.

GetWirelessDeviceImportTask (updated) Link ¶
Changes (response)
{'Positioning': 'Enabled | Disabled',
 'Sidewalk': {'Positioning': {'DestinationName': 'string'}}}

Get information about an import task and count of device onboarding summary information for the import task.

See also: AWS API Documentation

Request Syntax

client.get_wireless_device_import_task(
    Id='string'
)
type Id:

string

param Id:

[REQUIRED]

The identifier of the import task for which information is requested.

rtype:

dict

returns:

Response Syntax

{
    'Id': 'string',
    'Arn': 'string',
    'DestinationName': 'string',
    'Positioning': 'Enabled'|'Disabled',
    'Sidewalk': {
        'DeviceCreationFileList': [
            'string',
        ],
        'Role': 'string',
        'Positioning': {
            'DestinationName': 'string'
        }
    },
    'CreationTime': datetime(2015, 1, 1),
    'Status': 'INITIALIZING'|'INITIALIZED'|'PENDING'|'COMPLETE'|'FAILED'|'DELETING',
    'StatusReason': 'string',
    'InitializedImportedDeviceCount': 123,
    'PendingImportedDeviceCount': 123,
    'OnboardedImportedDeviceCount': 123,
    'FailedImportedDeviceCount': 123
}

Response Structure

  • (dict) --

    • Id (string) --

      The identifier of the import task for which information is retrieved.

    • Arn (string) --

      The ARN (Amazon Resource Name) of the import task.

    • DestinationName (string) --

      The name of the destination that's assigned to the wireless devices in the import task.

    • Positioning (string) --

      The integration status of the Device Location feature for LoRaWAN and Sidewalk devices.

    • Sidewalk (dict) --

      The Sidewalk-related information about an import task.

      • DeviceCreationFileList (list) --

        List of Sidewalk devices that are added to the import task.

        • (string) --

      • Role (string) --

        The IAM role that allows AWS IoT Wireless to access the CSV file in the S3 bucket.

      • Positioning (dict) --

        The Positioning object of the Sidewalk device.

        • DestinationName (string) --

          The location destination name of the Sidewalk device.

    • CreationTime (datetime) --

      The time at which the import task was created.

    • Status (string) --

      The import task status.

    • StatusReason (string) --

      The reason for the provided status information, such as a validation error that causes the import task to fail.

    • InitializedImportedDeviceCount (integer) --

      The number of devices in the import task that are waiting for the control log to start processing.

    • PendingImportedDeviceCount (integer) --

      The number of devices in the import task that are waiting in the import task queue to be onboarded.

    • OnboardedImportedDeviceCount (integer) --

      The number of devices in the import task that have been onboarded to the import task.

    • FailedImportedDeviceCount (integer) --

      The number of devices in the import task that failed to onboard to the import task.

ListDevicesForWirelessDeviceImportTask (updated) Link ¶
Changes (response)
{'Positioning': 'Enabled | Disabled',
 'Sidewalk': {'Positioning': {'DestinationName': 'string'}}}

List the Sidewalk devices in an import task and their onboarding status.

See also: AWS API Documentation

Request Syntax

client.list_devices_for_wireless_device_import_task(
    Id='string',
    MaxResults=123,
    NextToken='string',
    Status='INITIALIZED'|'PENDING'|'ONBOARDED'|'FAILED'
)
type Id:

string

param Id:

[REQUIRED]

The identifier of the import task for which wireless devices are listed.

type MaxResults:

integer

param MaxResults:

The maximum number of results to return in this operation.

type NextToken:

string

param NextToken:

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

type Status:

string

param Status:

The status of the devices in the import task.

rtype:

dict

returns:

Response Syntax

{
    'NextToken': 'string',
    'DestinationName': 'string',
    'Positioning': 'Enabled'|'Disabled',
    'Sidewalk': {
        'Positioning': {
            'DestinationName': 'string'
        }
    },
    'ImportedWirelessDeviceList': [
        {
            'Sidewalk': {
                'SidewalkManufacturingSn': 'string',
                'OnboardingStatus': 'INITIALIZED'|'PENDING'|'ONBOARDED'|'FAILED',
                'OnboardingStatusReason': 'string',
                'LastUpdateTime': datetime(2015, 1, 1)
            }
        },
    ]
}

Response Structure

  • (dict) --

    • NextToken (string) --

      The token to use to get the next set of results, or null if there are no additional results.

    • DestinationName (string) --

      The name of the Sidewalk destination that describes the IoT rule to route messages received from devices in an import task that are onboarded to AWS IoT Wireless.

    • Positioning (string) --

      The integration status of the Device Location feature for Sidewalk devices.

    • Sidewalk (dict) --

      The Sidewalk object containing Sidewalk-related device information.

      • Positioning (dict) --

        The Positioning object of the Sidewalk device.

        • DestinationName (string) --

          The location destination name of the Sidewalk device.

    • ImportedWirelessDeviceList (list) --

      List of wireless devices in an import task and their onboarding status.

      • (dict) --

        Information about a wireless device that has been added to an import task.

        • Sidewalk (dict) --

          The Sidewalk-related information about a device that has been added to an import task.

          • SidewalkManufacturingSn (string) --

            The Sidewalk manufacturing serial number (SMSN) of the Sidewalk device.

          • OnboardingStatus (string) --

            The onboarding status of the Sidewalk device in the import task.

          • OnboardingStatusReason (string) --

            The reason for the onboarding status information for the Sidewalk device.

          • LastUpdateTime (datetime) --

            The time at which the status information was last updated.

ListWirelessDeviceImportTasks (updated) Link ¶
Changes (response)
{'WirelessDeviceImportTaskList': {'Positioning': 'Enabled | Disabled',
                                  'Sidewalk': {'Positioning': {'DestinationName': 'string'}}}}

List of import tasks and summary information of onboarding status of devices in each import task.

See also: AWS API Documentation

Request Syntax

client.list_wireless_device_import_tasks(
    MaxResults=123,
    NextToken='string'
)
type MaxResults:

integer

param MaxResults:

The maximum number of results to return in this operation.

type NextToken:

string

param NextToken:

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

rtype:

dict

returns:

Response Syntax

{
    'NextToken': 'string',
    'WirelessDeviceImportTaskList': [
        {
            'Id': 'string',
            'Arn': 'string',
            'DestinationName': 'string',
            'Positioning': 'Enabled'|'Disabled',
            'Sidewalk': {
                'DeviceCreationFileList': [
                    'string',
                ],
                'Role': 'string',
                'Positioning': {
                    'DestinationName': 'string'
                }
            },
            'CreationTime': datetime(2015, 1, 1),
            'Status': 'INITIALIZING'|'INITIALIZED'|'PENDING'|'COMPLETE'|'FAILED'|'DELETING',
            'StatusReason': 'string',
            'InitializedImportedDeviceCount': 123,
            'PendingImportedDeviceCount': 123,
            'OnboardedImportedDeviceCount': 123,
            'FailedImportedDeviceCount': 123
        },
    ]
}

Response Structure

  • (dict) --

    • NextToken (string) --

      The token to use to get the next set of results, or null if there are no additional results.

    • WirelessDeviceImportTaskList (list) --

      List of import tasks and summary information of onboarding status of devices in each import task.

      • (dict) --

        Information about an import task for wireless devices.

        • Id (string) --

          The ID of the wireless device import task.

        • Arn (string) --

          The ARN (Amazon Resource Name) of the wireless device import task.

        • DestinationName (string) --

          The name of the Sidewalk destination that that describes the IoT rule to route messages from the device in the import task that will be onboarded to AWS IoT Wireless

        • Positioning (string) --

          The integration status of the Device Location feature for Sidewalk devices.

        • Sidewalk (dict) --

          The Sidewalk-related information of the wireless device import task.

          • DeviceCreationFileList (list) --

            List of Sidewalk devices that are added to the import task.

            • (string) --

          • Role (string) --

            The IAM role that allows AWS IoT Wireless to access the CSV file in the S3 bucket.

          • Positioning (dict) --

            The Positioning object of the Sidewalk device.

            • DestinationName (string) --

              The location destination name of the Sidewalk device.

        • CreationTime (datetime) --

          The time at which the import task was created.

        • Status (string) --

          The status information of the wireless device import task.

        • StatusReason (string) --

          The reason that provides additional information about the import task status.

        • InitializedImportedDeviceCount (integer) --

          The summary information of count of wireless devices that are waiting for the control log to be added to an import task.

        • PendingImportedDeviceCount (integer) --

          The summary information of count of wireless devices in an import task that are waiting in the queue to be onboarded.

        • OnboardedImportedDeviceCount (integer) --

          The summary information of count of wireless devices in an import task that have been onboarded to the import task.

        • FailedImportedDeviceCount (integer) --

          The summary information of count of wireless devices in an import task that failed to onboarded to the import task.

ListWirelessDevices (updated) Link ¶
Changes (response)
{'WirelessDeviceList': {'Positioning': 'Enabled | Disabled',
                        'Sidewalk': {'Positioning': {'DestinationName': 'string'}}}}

Lists the wireless devices registered to your AWS account.

See also: AWS API Documentation

Request Syntax

client.list_wireless_devices(
    MaxResults=123,
    NextToken='string',
    DestinationName='string',
    DeviceProfileId='string',
    ServiceProfileId='string',
    WirelessDeviceType='Sidewalk'|'LoRaWAN',
    FuotaTaskId='string',
    MulticastGroupId='string'
)
type MaxResults:

integer

param MaxResults:

The maximum number of results to return in this operation.

type NextToken:

string

param NextToken:

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

type DestinationName:

string

param DestinationName:

A filter to list only the wireless devices that use as uplink destination.

type DeviceProfileId:

string

param DeviceProfileId:

A filter to list only the wireless devices that use this device profile.

type ServiceProfileId:

string

param ServiceProfileId:

A filter to list only the wireless devices that use this service profile.

type WirelessDeviceType:

string

param WirelessDeviceType:

A filter to list only the wireless devices that use this wireless device type.

type FuotaTaskId:

string

param FuotaTaskId:

The ID of a FUOTA task.

type MulticastGroupId:

string

param MulticastGroupId:

The ID of the multicast group.

rtype:

dict

returns:

Response Syntax

{
    'NextToken': 'string',
    'WirelessDeviceList': [
        {
            'Arn': 'string',
            'Id': 'string',
            'Type': 'Sidewalk'|'LoRaWAN',
            'Name': 'string',
            'DestinationName': 'string',
            'LastUplinkReceivedAt': 'string',
            'LoRaWAN': {
                'DevEui': 'string'
            },
            'Sidewalk': {
                'AmazonId': 'string',
                'SidewalkId': 'string',
                'SidewalkManufacturingSn': 'string',
                'DeviceCertificates': [
                    {
                        'SigningAlg': 'Ed25519'|'P256r1',
                        'Value': 'string'
                    },
                ],
                'DeviceProfileId': 'string',
                'Status': 'PROVISIONED'|'REGISTERED'|'ACTIVATED'|'UNKNOWN',
                'Positioning': {
                    'DestinationName': 'string'
                }
            },
            'FuotaDeviceStatus': 'Initial'|'Package_Not_Supported'|'FragAlgo_unsupported'|'Not_enough_memory'|'FragIndex_unsupported'|'Wrong_descriptor'|'SessionCnt_replay'|'MissingFrag'|'MemoryError'|'MICError'|'Successful'|'Device_exist_in_conflict_fuota_task',
            'MulticastDeviceStatus': 'string',
            'McGroupId': 123,
            'Positioning': 'Enabled'|'Disabled'
        },
    ]
}

Response Structure

  • (dict) --

    • NextToken (string) --

      The token to use to get the next set of results, or null if there are no additional results.

    • WirelessDeviceList (list) --

      The ID of the wireless device.

      • (dict) --

        Information about a wireless device's operation.

        • Arn (string) --

          The Amazon Resource Name of the resource.

        • Id (string) --

          The ID of the wireless device reporting the data.

        • Type (string) --

          The wireless device type.

        • Name (string) --

          The name of the resource.

        • DestinationName (string) --

          The name of the destination to which the device is assigned.

        • LastUplinkReceivedAt (string) --

          The date and time when the most recent uplink was received.

        • LoRaWAN (dict) --

          LoRaWAN device info.

          • DevEui (string) --

            The DevEUI value.

        • Sidewalk (dict) --

          The Sidewalk account credentials.

          • AmazonId (string) --

            The Sidewalk Amazon ID.

          • SidewalkId (string) --

            The sidewalk device identification.

          • SidewalkManufacturingSn (string) --

            The Sidewalk manufacturing series number.

          • DeviceCertificates (list) --

            The sidewalk device certificates for Ed25519 and P256r1.

            • (dict) --

              List of sidewalk certificates.

              • SigningAlg (string) --

                The certificate chain algorithm provided by sidewalk.

              • Value (string) --

                The value of the chosen sidewalk certificate.

          • DeviceProfileId (string) --

            Sidewalk object used by list functions.

          • Status (string) --

            The status of the Sidewalk devices, such as provisioned or registered.

          • Positioning (dict) --

            The Positioning object of the Sidewalk device.

            • DestinationName (string) --

              The location destination name of the Sidewalk device.

        • FuotaDeviceStatus (string) --

          The status of a wireless device in a FUOTA task.

        • MulticastDeviceStatus (string) --

          The status of the wireless device in the multicast group.

        • McGroupId (integer) --

          Id of the multicast group.

        • Positioning (string) --

          The integration status of the Device Location feature for LoRaWAN and Amazon Sidewalk enabled devices.

StartSingleWirelessDeviceImportTask (updated) Link ¶
Changes (request)
{'Positioning': 'Enabled | Disabled',
 'Sidewalk': {'Positioning': {'DestinationName': 'string'}}}

Start import task for a single wireless device.

See also: AWS API Documentation

Request Syntax

client.start_single_wireless_device_import_task(
    DestinationName='string',
    ClientRequestToken='string',
    DeviceName='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    Positioning='Enabled'|'Disabled',
    Sidewalk={
        'SidewalkManufacturingSn': 'string',
        'Positioning': {
            'DestinationName': 'string'
        }
    }
)
type DestinationName:

string

param DestinationName:

[REQUIRED]

The name of the Sidewalk destination that describes the IoT rule to route messages from the device in the import task that will be onboarded to AWS IoT Wireless.

type ClientRequestToken:

string

param ClientRequestToken:

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

This field is autopopulated if not provided.

type DeviceName:

string

param DeviceName:

The name of the wireless device for which an import task is being started.

type Tags:

list

param Tags:

The tag to attach to the specified resource. Tags are metadata that you can use to manage a resource.

  • (dict) --

    A simple label consisting of a customer-defined key-value pair

    • Key (string) -- [REQUIRED]

      The tag's key value.

    • Value (string) -- [REQUIRED]

      The tag's value.

type Positioning:

string

param Positioning:

The integration status of the Device Location feature for Sidewalk devices.

type Sidewalk:

dict

param Sidewalk:

[REQUIRED]

The Sidewalk-related parameters for importing a single wireless device.

  • SidewalkManufacturingSn (string) --

    The Sidewalk manufacturing serial number (SMSN) of the device added to the import task.

  • Positioning (dict) --

    The Positioning object of the Sidewalk device.

    • DestinationName (string) --

      The location destination name of the Sidewalk device.

rtype:

dict

returns:

Response Syntax

{
    'Id': 'string',
    'Arn': 'string'
}

Response Structure

  • (dict) --

    • Id (string) --

      The import task ID.

    • Arn (string) --

      The ARN (Amazon Resource Name) of the import task.

StartWirelessDeviceImportTask (updated) Link ¶
Changes (request)
{'Positioning': 'Enabled | Disabled',
 'Sidewalk': {'Positioning': {'DestinationName': 'string'}}}

Start import task for provisioning Sidewalk devices in bulk using an S3 CSV file.

See also: AWS API Documentation

Request Syntax

client.start_wireless_device_import_task(
    DestinationName='string',
    ClientRequestToken='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    Positioning='Enabled'|'Disabled',
    Sidewalk={
        'DeviceCreationFile': 'string',
        'Role': 'string',
        'Positioning': {
            'DestinationName': 'string'
        }
    }
)
type DestinationName:

string

param DestinationName:

[REQUIRED]

The name of the Sidewalk destination that describes the IoT rule to route messages from the devices in the import task that are onboarded to AWS IoT Wireless.

type ClientRequestToken:

string

param ClientRequestToken:

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

This field is autopopulated if not provided.

type Tags:

list

param Tags:

The tag to attach to the specified resource. Tags are metadata that you can use to manage a resource.

  • (dict) --

    A simple label consisting of a customer-defined key-value pair

    • Key (string) -- [REQUIRED]

      The tag's key value.

    • Value (string) -- [REQUIRED]

      The tag's value.

type Positioning:

string

param Positioning:

The integration status of the Device Location feature for Sidewalk devices.

type Sidewalk:

dict

param Sidewalk:

[REQUIRED]

The Sidewalk-related parameters for importing wireless devices that need to be provisioned in bulk.

  • DeviceCreationFile (string) --

    The CSV file contained in an S3 bucket that's used for adding devices to an import task.

  • Role (string) --

    The IAM role that allows AWS IoT Wireless to access the CSV file in the S3 bucket.

  • Positioning (dict) --

    The Positioning object of the Sidewalk device.

    • DestinationName (string) --

      The location destination name of the Sidewalk device.

rtype:

dict

returns:

Response Syntax

{
    'Id': 'string',
    'Arn': 'string'
}

Response Structure

  • (dict) --

    • Id (string) --

      The import task ID.

    • Arn (string) --

      The ARN (Amazon Resource Name) of the import task.

UpdateWirelessDevice (updated) Link ¶
Changes (request)
{'Sidewalk': {'Positioning': {'DestinationName': 'string'}}}

Updates properties of a wireless device.

See also: AWS API Documentation

Request Syntax

client.update_wireless_device(
    Id='string',
    DestinationName='string',
    Name='string',
    Description='string',
    LoRaWAN={
        'DeviceProfileId': 'string',
        'ServiceProfileId': 'string',
        'AbpV1_1': {
            'FCntStart': 123
        },
        'AbpV1_0_x': {
            'FCntStart': 123
        },
        'FPorts': {
            'Positioning': {
                'ClockSync': 123,
                'Stream': 123,
                'Gnss': 123
            },
            'Applications': [
                {
                    'FPort': 123,
                    'Type': 'SemtechGeolocation',
                    'DestinationName': 'string'
                },
            ]
        }
    },
    Positioning='Enabled'|'Disabled',
    Sidewalk={
        'Positioning': {
            'DestinationName': 'string'
        }
    }
)
type Id:

string

param Id:

[REQUIRED]

The ID of the resource to update.

type DestinationName:

string

param DestinationName:

The name of the new destination for the device.

type Name:

string

param Name:

The new name of the resource.

type Description:

string

param Description:

A new description of the resource.

type LoRaWAN:

dict

param LoRaWAN:

The updated wireless device's configuration.

  • DeviceProfileId (string) --

    The ID of the device profile for the wireless device.

  • ServiceProfileId (string) --

    The ID of the service profile.

  • AbpV1_1 (dict) --

    ABP device object for update APIs for v1.1

    • FCntStart (integer) --

      The FCnt init value.

  • AbpV1_0_x (dict) --

    ABP device object for update APIs for v1.0.x

    • FCntStart (integer) --

      The FCnt init value.

  • FPorts (dict) --

    FPorts object for the positioning information of the device.

    • Positioning (dict) --

      Positioning FPorts for the ClockSync, Stream, and GNSS functions.

      • ClockSync (integer) --

        The Fport value.

      • Stream (integer) --

        The Fport value.

      • Gnss (integer) --

        The Fport value.

    • Applications (list) --

      LoRaWAN application, which can be used for geolocation by activating positioning.

      • (dict) --

        LoRaWAN application configuration, which can be used to perform geolocation.

        • FPort (integer) --

          The Fport value.

        • Type (string) --

          Application type, which can be specified to obtain real-time position information of your LoRaWAN device.

        • DestinationName (string) --

          The name of the position data destination that describes the AWS IoT rule that processes the device's position data for use by AWS IoT Core for LoRaWAN.

type Positioning:

string

param Positioning:

The integration status of the Device Location feature for LoRaWAN and Sidewalk devices.

type Sidewalk:

dict

param Sidewalk:

The updated sidewalk properties.

  • Positioning (dict) --

    The Positioning object of the Sidewalk device.

    • DestinationName (string) --

      The location destination name of the Sidewalk device.

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --