AWS IoT Wireless

2021/11/04 - AWS IoT Wireless - 26 new 3 updated api methods

Changes  Adding APIs for the FUOTA (firmware update over the air) and multicast for LoRaWAN devices and APIs to support event notification opt-in feature for Sidewalk related events. A few existing APIs need to be modified for this new feature.

CancelMulticastGroupSession (new) Link ¶

Cancels an existing multicast group session.

See also: AWS API Documentation

Request Syntax

client.cancel_multicast_group_session(
    Id='string'
)
type Id

string

param Id

[REQUIRED]

The ID of the multicast group.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

AssociateWirelessDeviceWithMulticastGroup (new) Link ¶

Associates a wireless device with a multicast group.

See also: AWS API Documentation

Request Syntax

client.associate_wireless_device_with_multicast_group(
    Id='string',
    WirelessDeviceId='string'
)
type Id

string

param Id

[REQUIRED]

The ID of the multicast group.

type WirelessDeviceId

string

param WirelessDeviceId

[REQUIRED]

The ID of the wireless device.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

DeleteFuotaTask (new) Link ¶

Deletes a FUOTA task.

See also: AWS API Documentation

Request Syntax

client.delete_fuota_task(
    Id='string'
)
type Id

string

param Id

[REQUIRED]

The ID of a FUOTA task.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

UpdateFuotaTask (new) Link ¶

Updates properties of a FUOTA task.

See also: AWS API Documentation

Request Syntax

client.update_fuota_task(
    Id='string',
    Name='string',
    Description='string',
    LoRaWAN={
        'RfRegion': 'EU868'|'US915'|'AU915'|'AS923-1'
    },
    FirmwareUpdateImage='string',
    FirmwareUpdateRole='string'
)
type Id

string

param Id

[REQUIRED]

The ID of a FUOTA task.

type Name

string

param Name

The name of a FUOTA task.

type Description

string

param Description

The description of the new resource.

type LoRaWAN

dict

param LoRaWAN

The LoRaWAN information used with a FUOTA task.

  • RfRegion (string) --

    Supported RfRegions

type FirmwareUpdateImage

string

param FirmwareUpdateImage

The S3 URI points to a firmware update image that is to be used with a FUOTA task.

type FirmwareUpdateRole

string

param FirmwareUpdateRole

The firmware update role that is to be used with a FUOTA task.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

UpdateResourceEventConfiguration (new) Link ¶

Update the event configuration for a particular resource identifier.

See also: AWS API Documentation

Request Syntax

client.update_resource_event_configuration(
    Identifier='string',
    IdentifierType='PartnerAccountId',
    PartnerType='Sidewalk',
    DeviceRegistrationState={
        'Sidewalk': {
            'AmazonIdEventTopic': 'Enabled'|'Disabled'
        }
    },
    Proximity={
        'Sidewalk': {
            'AmazonIdEventTopic': 'Enabled'|'Disabled'
        }
    }
)
type Identifier

string

param Identifier

[REQUIRED]

Resource identifier to opt in for event messaging.

type IdentifierType

string

param IdentifierType

[REQUIRED]

Identifier type of the particular resource identifier for event configuration.

type PartnerType

string

param PartnerType

Partner type of the resource if the identifier type is PartnerAccountId

type DeviceRegistrationState

dict

param DeviceRegistrationState

Event configuration for the device registration state event

  • Sidewalk (dict) --

    Device registration state event configuration object for enabling or disabling Sidewalk related event topics.

    • AmazonIdEventTopic (string) --

      Enum to denote whether amazon id event topic is enabled or disabled.

type Proximity

dict

param Proximity

Event configuration for the Proximity event

  • Sidewalk (dict) --

    Proximity event configuration object for enabling or disabling Sidewalk related event topics.

    • AmazonIdEventTopic (string) --

      Enum to denote whether amazon id event topic is enabled or disabled.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

GetMulticastGroup (new) Link ¶

Gets information about a multicast group.

See also: AWS API Documentation

Request Syntax

client.get_multicast_group(
    Id='string'
)
type Id

string

param Id

[REQUIRED]

The ID of the multicast group.

rtype

dict

returns

Response Syntax

{
    'Arn': 'string',
    'Id': 'string',
    'Name': 'string',
    'Description': 'string',
    'Status': 'string',
    'LoRaWAN': {
        'RfRegion': 'EU868'|'US915'|'AU915'|'AS923-1',
        'DlClass': 'ClassB'|'ClassC',
        'NumberOfDevicesRequested': 123,
        'NumberOfDevicesInGroup': 123
    },
    'CreatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • Arn (string) --

      The arn of the multicast group.

    • Id (string) --

      The ID of the multicast group.

    • Name (string) --

      The name of the multicast group.

    • Description (string) --

      The description of the new resource.

    • Status (string) --

      The status of the multicast group.

    • LoRaWAN (dict) --

      The LoRaWAN information that is to be returned from getting multicast group information.

      • RfRegion (string) --

        Supported RfRegions

      • DlClass (string) --

        DlClass for LoRaWAM, valid values are ClassB and ClassC.

      • NumberOfDevicesRequested (integer) --

        Number of devices that are requested to be associated with the multicast group.

      • NumberOfDevicesInGroup (integer) --

        Number of devices that are associated to the multicast group.

    • CreatedAt (datetime) --

      Created at timestamp for the resource.

UpdateMulticastGroup (new) Link ¶

Updates properties of a multicast group session.

See also: AWS API Documentation

Request Syntax

client.update_multicast_group(
    Id='string',
    Name='string',
    Description='string',
    LoRaWAN={
        'RfRegion': 'EU868'|'US915'|'AU915'|'AS923-1',
        'DlClass': 'ClassB'|'ClassC'
    }
)
type Id

string

param Id

[REQUIRED]

The ID of the multicast group.

type Name

string

param Name

The name of the multicast group.

type Description

string

param Description

The description of the new resource.

type LoRaWAN

dict

param LoRaWAN

The LoRaWAN information that is to be used with the multicast group.

  • RfRegion (string) --

    Supported RfRegions

  • DlClass (string) --

    DlClass for LoRaWAM, valid values are ClassB and ClassC.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

GetFuotaTask (new) Link ¶

Gets information about a FUOTA task.

See also: AWS API Documentation

Request Syntax

client.get_fuota_task(
    Id='string'
)
type Id

string

param Id

[REQUIRED]

The ID of a FUOTA task.

rtype

dict

returns

Response Syntax

{
    'Arn': 'string',
    'Id': 'string',
    'Status': 'Pending'|'FuotaSession_Waiting'|'In_FuotaSession'|'FuotaDone'|'Delete_Waiting',
    'Name': 'string',
    'Description': 'string',
    'LoRaWAN': {
        'RfRegion': 'string',
        'StartTime': datetime(2015, 1, 1)
    },
    'FirmwareUpdateImage': 'string',
    'FirmwareUpdateRole': 'string',
    'CreatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • Arn (string) --

      The arn of a FUOTA task.

    • Id (string) --

      The ID of a FUOTA task.

    • Status (string) --

      The status of a FUOTA task.

    • Name (string) --

      The name of a FUOTA task.

    • Description (string) --

      The description of the new resource.

    • LoRaWAN (dict) --

      The LoRaWAN information returned from getting a FUOTA task.

      • RfRegion (string) --

        The frequency band (RFRegion) value.

      • StartTime (datetime) --

        Start time of a FUOTA task.

    • FirmwareUpdateImage (string) --

      The S3 URI points to a firmware update image that is to be used with a FUOTA task.

    • FirmwareUpdateRole (string) --

      The firmware update role that is to be used with a FUOTA task.

    • CreatedAt (datetime) --

      Created at timestamp for the resource.

DeleteMulticastGroup (new) Link ¶

Deletes a multicast group if it is not in use by a fuota task.

See also: AWS API Documentation

Request Syntax

client.delete_multicast_group(
    Id='string'
)
type Id

string

param Id

[REQUIRED]

The ID of the multicast group.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

DisassociateWirelessDeviceFromFuotaTask (new) Link ¶

Disassociates a wireless device from a FUOTA task.

See also: AWS API Documentation

Request Syntax

client.disassociate_wireless_device_from_fuota_task(
    Id='string',
    WirelessDeviceId='string'
)
type Id

string

param Id

[REQUIRED]

The ID of a FUOTA task.

type WirelessDeviceId

string

param WirelessDeviceId

[REQUIRED]

The ID of the wireless device.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

StartMulticastGroupSession (new) Link ¶

Starts a multicast group session.

See also: AWS API Documentation

Request Syntax

client.start_multicast_group_session(
    Id='string',
    LoRaWAN={
        'DlDr': 123,
        'DlFreq': 123,
        'SessionStartTime': datetime(2015, 1, 1),
        'SessionTimeout': 123
    }
)
type Id

string

param Id

[REQUIRED]

The ID of the multicast group.

type LoRaWAN

dict

param LoRaWAN

[REQUIRED]

The LoRaWAN information used with the multicast session.

  • DlDr (integer) --

    Downlink data rate.

  • DlFreq (integer) --

    Downlink frequency.

  • SessionStartTime (datetime) --

    Timestamp of when the multicast group session is to start.

  • SessionTimeout (integer) --

    How long before a multicast group session is to timeout.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

AssociateWirelessDeviceWithFuotaTask (new) Link ¶

Associate a wireless device with a FUOTA task.

See also: AWS API Documentation

Request Syntax

client.associate_wireless_device_with_fuota_task(
    Id='string',
    WirelessDeviceId='string'
)
type Id

string

param Id

[REQUIRED]

The ID of a FUOTA task.

type WirelessDeviceId

string

param WirelessDeviceId

[REQUIRED]

The ID of the wireless device.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

GetResourceEventConfiguration (new) Link ¶

Get the event configuration for a particular resource identifier.

See also: AWS API Documentation

Request Syntax

client.get_resource_event_configuration(
    Identifier='string',
    IdentifierType='PartnerAccountId',
    PartnerType='Sidewalk'
)
type Identifier

string

param Identifier

[REQUIRED]

Resource identifier to opt in for event messaging.

type IdentifierType

string

param IdentifierType

[REQUIRED]

Identifier type of the particular resource identifier for event configuration.

type PartnerType

string

param PartnerType

Partner type of the resource if the identifier type is PartnerAccountId.

rtype

dict

returns

Response Syntax

{
    'DeviceRegistrationState': {
        'Sidewalk': {
            'AmazonIdEventTopic': 'Enabled'|'Disabled'
        }
    },
    'Proximity': {
        'Sidewalk': {
            'AmazonIdEventTopic': 'Enabled'|'Disabled'
        }
    }
}

Response Structure

  • (dict) --

    • DeviceRegistrationState (dict) --

      Event configuration for the device registration state event

      • Sidewalk (dict) --

        Device registration state event configuration object for enabling or disabling Sidewalk related event topics.

        • AmazonIdEventTopic (string) --

          Enum to denote whether amazon id event topic is enabled or disabled.

    • Proximity (dict) --

      Event configuration for the Proximity event

      • Sidewalk (dict) --

        Proximity event configuration object for enabling or disabling Sidewalk related event topics.

        • AmazonIdEventTopic (string) --

          Enum to denote whether amazon id event topic is enabled or disabled.

StartBulkDisassociateWirelessDeviceFromMulticastGroup (new) Link ¶

Starts a bulk disassociatin of all qualifying wireless devices from a multicast group.

See also: AWS API Documentation

Request Syntax

client.start_bulk_disassociate_wireless_device_from_multicast_group(
    Id='string',
    QueryString='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
type Id

string

param Id

[REQUIRED]

The ID of the multicast group.

type QueryString

string

param QueryString

Query string used to search for wireless devices as part of the bulk associate and disassociate process.

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.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

CreateMulticastGroup (new) Link ¶

Creates a multicast group.

See also: AWS API Documentation

Request Syntax

client.create_multicast_group(
    Name='string',
    Description='string',
    ClientRequestToken='string',
    LoRaWAN={
        'RfRegion': 'EU868'|'US915'|'AU915'|'AS923-1',
        'DlClass': 'ClassB'|'ClassC'
    },
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
type Name

string

param Name

The name of the multicast group.

type Description

string

param Description

The description of the multicast group.

type ClientRequestToken

string

param ClientRequestToken

Each resource must have a unique client request token. If you try to create a new resource with the same token as a resource that already exists, an exception occurs. If you omit this value, AWS SDKs will automatically generate a unique client request.

This field is autopopulated if not provided.

type LoRaWAN

dict

param LoRaWAN

[REQUIRED]

The LoRaWAN information that is to be used with the multicast group.

  • RfRegion (string) --

    Supported RfRegions

  • DlClass (string) --

    DlClass for LoRaWAM, valid values are ClassB and ClassC.

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.

rtype

dict

returns

Response Syntax

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

Response Structure

  • (dict) --

    • Arn (string) --

      The arn of the multicast group.

    • Id (string) --

      The ID of the multicast group.

StartBulkAssociateWirelessDeviceWithMulticastGroup (new) Link ¶

Starts a bulk association of all qualifying wireless devices with a multicast group.

See also: AWS API Documentation

Request Syntax

client.start_bulk_associate_wireless_device_with_multicast_group(
    Id='string',
    QueryString='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
type Id

string

param Id

[REQUIRED]

The ID of the multicast group.

type QueryString

string

param QueryString

Query string used to search for wireless devices as part of the bulk associate and disassociate process.

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.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

ListMulticastGroups (new) Link ¶

Lists the multicast groups registered to your AWS account.

See also: AWS API Documentation

Request Syntax

client.list_multicast_groups(
    NextToken='string',
    MaxResults=123
)
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 MaxResults

integer

param MaxResults

The maximum number of results to return in this operation.

rtype

dict

returns

Response Syntax

{
    'NextToken': 'string',
    'MulticastGroupList': [
        {
            'Id': 'string',
            'Arn': 'string',
            'Name': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • NextToken (string) --

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

    • MulticastGroupList (list) --

      List of multicast groups.

      • (dict) --

        A multicast group.

        • Id (string) --

          The ID of the multicast group.

        • Arn (string) --

          The arn of the multicast group.

        • Name (string) --

          The name of the multicast group.

CreateFuotaTask (new) Link ¶

Creates a FUOTA task.

See also: AWS API Documentation

Request Syntax

client.create_fuota_task(
    Name='string',
    Description='string',
    ClientRequestToken='string',
    LoRaWAN={
        'RfRegion': 'EU868'|'US915'|'AU915'|'AS923-1'
    },
    FirmwareUpdateImage='string',
    FirmwareUpdateRole='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
type Name

string

param Name

The name of a FUOTA task.

type Description

string

param Description

The description of the new resource.

type ClientRequestToken

string

param ClientRequestToken

Each resource must have a unique client request token. If you try to create a new resource with the same token as a resource that already exists, an exception occurs. If you omit this value, AWS SDKs will automatically generate a unique client request.

This field is autopopulated if not provided.

type LoRaWAN

dict

param LoRaWAN

The LoRaWAN information used with a FUOTA task.

  • RfRegion (string) --

    Supported RfRegions

type FirmwareUpdateImage

string

param FirmwareUpdateImage

[REQUIRED]

The S3 URI points to a firmware update image that is to be used with a FUOTA task.

type FirmwareUpdateRole

string

param FirmwareUpdateRole

[REQUIRED]

The firmware update role that is to be used with a FUOTA task.

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.

rtype

dict

returns

Response Syntax

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

Response Structure

  • (dict) --

    • Arn (string) --

      The arn of a FUOTA task.

    • Id (string) --

      The ID of a FUOTA task.

ListMulticastGroupsByFuotaTask (new) Link ¶

List all multicast groups associated with a fuota task.

See also: AWS API Documentation

Request Syntax

client.list_multicast_groups_by_fuota_task(
    Id='string',
    NextToken='string',
    MaxResults=123
)
type Id

string

param Id

[REQUIRED]

The ID of a FUOTA task.

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 MaxResults

integer

param MaxResults

The maximum number of results to return in this operation.

rtype

dict

returns

Response Syntax

{
    'NextToken': 'string',
    'MulticastGroupList': [
        {
            'Id': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • NextToken (string) --

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

    • MulticastGroupList (list) --

      List of multicast groups associated with a FUOTA task.

      • (dict) --

        A multicast group that is associated with a FUOTA task.

        • Id (string) --

          The ID of the multicast group.

DisassociateWirelessDeviceFromMulticastGroup (new) Link ¶

Disassociates a wireless device from a multicast group.

See also: AWS API Documentation

Request Syntax

client.disassociate_wireless_device_from_multicast_group(
    Id='string',
    WirelessDeviceId='string'
)
type Id

string

param Id

[REQUIRED]

The ID of the multicast group.

type WirelessDeviceId

string

param WirelessDeviceId

[REQUIRED]

The ID of the wireless device.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

StartFuotaTask (new) Link ¶

Starts a FUOTA task.

See also: AWS API Documentation

Request Syntax

client.start_fuota_task(
    Id='string',
    LoRaWAN={
        'StartTime': datetime(2015, 1, 1)
    }
)
type Id

string

param Id

[REQUIRED]

The ID of a FUOTA task.

type LoRaWAN

dict

param LoRaWAN

The LoRaWAN information used to start a FUOTA task.

  • StartTime (datetime) --

    Start time of a FUOTA task.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

ListFuotaTasks (new) Link ¶

Lists the FUOTA tasks registered to your AWS account.

See also: AWS API Documentation

Request Syntax

client.list_fuota_tasks(
    NextToken='string',
    MaxResults=123
)
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 MaxResults

integer

param MaxResults

The maximum number of results to return in this operation.

rtype

dict

returns

Response Syntax

{
    'NextToken': 'string',
    'FuotaTaskList': [
        {
            'Id': 'string',
            'Arn': 'string',
            'Name': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • NextToken (string) --

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

    • FuotaTaskList (list) --

      Lists the FUOTA tasks registered to your AWS account.

      • (dict) --

        A FUOTA task.

        • Id (string) --

          The ID of a FUOTA task.

        • Arn (string) --

          The arn of a FUOTA task.

        • Name (string) --

          The name of a FUOTA task.

DisassociateMulticastGroupFromFuotaTask (new) Link ¶

Disassociates a multicast group from a fuota task.

See also: AWS API Documentation

Request Syntax

client.disassociate_multicast_group_from_fuota_task(
    Id='string',
    MulticastGroupId='string'
)
type Id

string

param Id

[REQUIRED]

The ID of a FUOTA task.

type MulticastGroupId

string

param MulticastGroupId

[REQUIRED]

The ID of the multicast group.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

GetMulticastGroupSession (new) Link ¶

Gets information about a multicast group session.

See also: AWS API Documentation

Request Syntax

client.get_multicast_group_session(
    Id='string'
)
type Id

string

param Id

[REQUIRED]

The ID of the multicast group.

rtype

dict

returns

Response Syntax

{
    'LoRaWAN': {
        'DlDr': 123,
        'DlFreq': 123,
        'SessionStartTime': datetime(2015, 1, 1),
        'SessionTimeout': 123
    }
}

Response Structure

  • (dict) --

    • LoRaWAN (dict) --

      The LoRaWAN information used with the multicast session.

      • DlDr (integer) --

        Downlink data rate.

      • DlFreq (integer) --

        Downlink frequency.

      • SessionStartTime (datetime) --

        Timestamp of when the multicast group session is to start.

      • SessionTimeout (integer) --

        How long before a multicast group session is to timeout.

SendDataToMulticastGroup (new) Link ¶

Sends the specified data to a multicast group.

See also: AWS API Documentation

Request Syntax

client.send_data_to_multicast_group(
    Id='string',
    PayloadData='string',
    WirelessMetadata={
        'LoRaWAN': {
            'FPort': 123
        }
    }
)
type Id

string

param Id

[REQUIRED]

The ID of the multicast group.

type PayloadData

string

param PayloadData

[REQUIRED]

The binary to be sent to the end device, encoded in base64.

type WirelessMetadata

dict

param WirelessMetadata

[REQUIRED]

Wireless metadata that is to be sent to multicast group.

  • LoRaWAN (dict) --

    The metadata information of the LoRaWAN multicast group.

    • FPort (integer) --

      The Fport value.

rtype

dict

returns

Response Syntax

{
    'MessageId': 'string'
}

Response Structure

  • (dict) --

    • MessageId (string) --

      ID of a multicast group message.

AssociateMulticastGroupWithFuotaTask (new) Link ¶

Associate a multicast group with a FUOTA task.

See also: AWS API Documentation

Request Syntax

client.associate_multicast_group_with_fuota_task(
    Id='string',
    MulticastGroupId='string'
)
type Id

string

param Id

[REQUIRED]

The ID of a FUOTA task.

type MulticastGroupId

string

param MulticastGroupId

[REQUIRED]

The ID of the multicast group.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --

CreateWirelessDevice (updated) Link ¶
Changes (request)
{'LoRaWAN': {'FPorts': {'ClockSync': 'integer',
                        'Fuota': 'integer',
                        'Multicast': 'integer'},
             'OtaaV1_0_x': {'GenAppKey': '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',
            'GenAppKey': 'string'
        },
        'AbpV1_1': {
            'DevAddr': 'string',
            'SessionKeys': {
                'FNwkSIntKey': 'string',
                'SNwkSIntKey': 'string',
                'NwkSEncKey': 'string',
                'AppSKey': 'string'
            }
        },
        'AbpV1_0_x': {
            'DevAddr': 'string',
            'SessionKeys': {
                'NwkSKey': 'string',
                'AppSKey': 'string'
            }
        },
        'FPorts': {
            'Fuota': 123,
            'Multicast': 123,
            'ClockSync': 123
        }
    },
    Tags=[
        {
            'Key': 'string',
            'Value': '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. If you try to create a new resource with the same token as a resource that already exists, an exception occurs. If you omit this value, AWS SDKs will automatically generate a unique client request.

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.

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

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

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

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.

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)
{'LoRaWAN': {'FPorts': {'ClockSync': 'integer',
                        'Fuota': 'integer',
                        'Multicast': 'integer'},
             'OtaaV1_0_x': {'GenAppKey': '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',
            'GenAppKey': 'string'
        },
        'AbpV1_1': {
            'DevAddr': 'string',
            'SessionKeys': {
                'FNwkSIntKey': 'string',
                'SNwkSIntKey': 'string',
                'NwkSEncKey': 'string',
                'AppSKey': 'string'
            }
        },
        'AbpV1_0_x': {
            'DevAddr': 'string',
            'SessionKeys': {
                'NwkSKey': 'string',
                'AppSKey': 'string'
            }
        },
        'FPorts': {
            'Fuota': 123,
            'Multicast': 123,
            'ClockSync': 123
        }
    },
    'Sidewalk': {
        'AmazonId': 'string',
        'SidewalkId': 'string',
        'SidewalkManufacturingSn': 'string',
        'DeviceCertificates': [
            {
                'SigningAlg': 'Ed25519'|'P256r1',
                'Value': 'string'
            },
        ]
    }
}

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.

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

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

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

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

ListWirelessDevices (updated) Link ¶
Changes (request, response)
Request
{'FuotaTaskId': 'string', 'MulticastGroupId': 'string'}
Response
{'WirelessDeviceList': {'FuotaDeviceStatus': 'Initial | Package_Not_Supported '
                                             '| FragAlgo_unsupported | '
                                             'Not_enough_memory | '
                                             'FragIndex_unsupported | '
                                             'Wrong_descriptor | '
                                             'SessionCnt_replay | MissingFrag '
                                             '| MemoryError | MICError | '
                                             'Successful',
                        'McGroupId': 'integer',
                        'MulticastDeviceStatus': '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 this 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'
                    },
                ]
            },
            'FuotaDeviceStatus': 'Initial'|'Package_Not_Supported'|'FragAlgo_unsupported'|'Not_enough_memory'|'FragIndex_unsupported'|'Wrong_descriptor'|'SessionCnt_replay'|'MissingFrag'|'MemoryError'|'MICError'|'Successful',
            'MulticastDeviceStatus': 'string',
            'McGroupId': 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.

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

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