AWS IoT Wireless

2022/04/27 - AWS IoT Wireless - 6 new7 updated api methods

Changes  Add list support for event configurations, allow to get and update event configurations by resource type, support LoRaWAN events; Make NetworkAnalyzerConfiguration as a resource, add List, Create, Delete API support; Add FCntStart attribute support for ABP WirelessDevice.

UpdateEventConfigurationByResourceTypes (new) Link ¶

Update the event configuration by resource types.

See also: AWS API Documentation

Request Syntax

client.update_event_configuration_by_resource_types(
    DeviceRegistrationState={
        'Sidewalk': {
            'WirelessDeviceEventTopic': 'Enabled'|'Disabled'
        }
    },
    Proximity={
        'Sidewalk': {
            'WirelessDeviceEventTopic': 'Enabled'|'Disabled'
        }
    },
    Join={
        'LoRaWAN': {
            'WirelessDeviceEventTopic': 'Enabled'|'Disabled'
        }
    },
    ConnectionStatus={
        'LoRaWAN': {
            'WirelessGatewayEventTopic': 'Enabled'|'Disabled'
        }
    }
)
type DeviceRegistrationState:

dict

param DeviceRegistrationState:

Device registration state resource type event configuration object for enabling and disabling wireless gateway topic.

  • Sidewalk (dict) --

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

    • WirelessDeviceEventTopic (string) --

      Enum to denote whether the wireless device join event topic is enabled or disabled.

type Proximity:

dict

param Proximity:

Proximity resource type event configuration object for enabling and disabling wireless gateway topic.

  • Sidewalk (dict) --

    Proximity resource type event configuration object for enabling and disabling wireless device topic.

    • WirelessDeviceEventTopic (string) --

      Enum to denote whether the wireless device join event topic is enabled or disabled.

type Join:

dict

param Join:

Join resource type event configuration object for enabling and disabling wireless device topic.

  • LoRaWAN (dict) --

    Join resource type event configuration object for enabling or disabling LoRaWAN related event topics.

    • WirelessDeviceEventTopic (string) --

      Enum to denote whether the wireless device join event topic is enabled or disabled.

type ConnectionStatus:

dict

param ConnectionStatus:

Connection status resource type event configuration object for enabling and disabling wireless gateway topic.

  • LoRaWAN (dict) --

    Connection status resource type event configuration object for enabling or disabling LoRaWAN related event topics.

    • WirelessGatewayEventTopic (string) --

      Enum to denote whether the wireless gateway connection status event topic is enabled or disabled.

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --

CreateNetworkAnalyzerConfiguration (new) Link ¶

Creates a new network analyzer configuration.

See also: AWS API Documentation

Request Syntax

client.create_network_analyzer_configuration(
    Name='string',
    TraceContent={
        'WirelessDeviceFrameInfo': 'ENABLED'|'DISABLED',
        'LogLevel': 'INFO'|'ERROR'|'DISABLED'
    },
    WirelessDevices=[
        'string',
    ],
    WirelessGateways=[
        'string',
    ],
    Description='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    ClientRequestToken='string'
)
type Name:

string

param Name:

[REQUIRED]

Name of the network analyzer configuration.

type TraceContent:

dict

param TraceContent:

Trace content for your wireless gateway and wireless device resources.

  • WirelessDeviceFrameInfo (string) --

    FrameInfo of your wireless device resources for the trace content. Use FrameInfo to debug the communication between your LoRaWAN end devices and the network server.

  • LogLevel (string) --

    The log level for a log message. The log levels can be disabled, or set to ERROR to display less verbose logs containing only error information, or to INFO for more detailed logs.

type WirelessDevices:

list

param WirelessDevices:

Wireless device resources to add to the network analyzer configuration. Provide the WirelessDeviceId of the resource to add in the input array.

  • (string) --

    The ID of the wireless device.

type WirelessGateways:

list

param WirelessGateways:

Wireless gateway resources to add to the network analyzer configuration. Provide the WirelessGatewayId of the resource to add in the input array.

  • (string) --

type Description:

string

param Description:

The description of the new resource.

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

rtype:

dict

returns:

Response Syntax

{
    'Arn': 'string',
    'Name': 'string'
}

Response Structure

  • (dict) --

    • Arn (string) --

      The Amazon Resource Name of the new resource.

    • Name (string) --

      Name of the network analyzer configuration.

GetEventConfigurationByResourceTypes (new) Link ¶

Get the event configuration by resource types.

See also: AWS API Documentation

Request Syntax

client.get_event_configuration_by_resource_types()
rtype:

dict

returns:

Response Syntax

{
    'DeviceRegistrationState': {
        'Sidewalk': {
            'WirelessDeviceEventTopic': 'Enabled'|'Disabled'
        }
    },
    'Proximity': {
        'Sidewalk': {
            'WirelessDeviceEventTopic': 'Enabled'|'Disabled'
        }
    },
    'Join': {
        'LoRaWAN': {
            'WirelessDeviceEventTopic': 'Enabled'|'Disabled'
        }
    },
    'ConnectionStatus': {
        'LoRaWAN': {
            'WirelessGatewayEventTopic': 'Enabled'|'Disabled'
        }
    }
}

Response Structure

  • (dict) --

    • DeviceRegistrationState (dict) --

      Resource type event configuration for the device registration state event

      • Sidewalk (dict) --

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

        • WirelessDeviceEventTopic (string) --

          Enum to denote whether the wireless device join event topic is enabled or disabled.

    • Proximity (dict) --

      Resource type event configuration for the proximity event

      • Sidewalk (dict) --

        Proximity resource type event configuration object for enabling and disabling wireless device topic.

        • WirelessDeviceEventTopic (string) --

          Enum to denote whether the wireless device join event topic is enabled or disabled.

    • Join (dict) --

      Resource type event configuration for the join event

      • LoRaWAN (dict) --

        Join resource type event configuration object for enabling or disabling LoRaWAN related event topics.

        • WirelessDeviceEventTopic (string) --

          Enum to denote whether the wireless device join event topic is enabled or disabled.

    • ConnectionStatus (dict) --

      Resource type event configuration for the connection status event

      • LoRaWAN (dict) --

        Connection status resource type event configuration object for enabling or disabling LoRaWAN related event topics.

        • WirelessGatewayEventTopic (string) --

          Enum to denote whether the wireless gateway connection status event topic is enabled or disabled.

ListNetworkAnalyzerConfigurations (new) Link ¶

Lists the network analyzer configurations.

See also: AWS API Documentation

Request Syntax

client.list_network_analyzer_configurations(
    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',
    'NetworkAnalyzerConfigurationList': [
        {
            'Arn': 'string',
            'Name': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • NextToken (string) --

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

    • NetworkAnalyzerConfigurationList (list) --

      The list of network analyzer configurations.

      • (dict) --

        Network analyzer configurations.

        • Arn (string) --

          The Amazon Resource Name of the new resource.

        • Name (string) --

          Name of the network analyzer configuration.

ListEventConfigurations (new) Link ¶

List event configurations where at least one event topic has been enabled.

See also: AWS API Documentation

Request Syntax

client.list_event_configurations(
    ResourceType='SidewalkAccount'|'WirelessDevice'|'WirelessGateway',
    MaxResults=123,
    NextToken='string'
)
type ResourceType:

string

param ResourceType:

[REQUIRED]

Resource type to filter event configurations.

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',
    'EventConfigurationsList': [
        {
            'Identifier': 'string',
            'IdentifierType': 'PartnerAccountId'|'DevEui'|'GatewayEui'|'WirelessDeviceId'|'WirelessGatewayId',
            'PartnerType': 'Sidewalk',
            'Events': {
                'DeviceRegistrationState': {
                    'Sidewalk': {
                        'AmazonIdEventTopic': 'Enabled'|'Disabled'
                    },
                    'WirelessDeviceIdEventTopic': 'Enabled'|'Disabled'
                },
                'Proximity': {
                    'Sidewalk': {
                        'AmazonIdEventTopic': 'Enabled'|'Disabled'
                    },
                    'WirelessDeviceIdEventTopic': 'Enabled'|'Disabled'
                },
                'Join': {
                    'LoRaWAN': {
                        'DevEuiEventTopic': 'Enabled'|'Disabled'
                    },
                    'WirelessDeviceIdEventTopic': 'Enabled'|'Disabled'
                },
                'ConnectionStatus': {
                    'LoRaWAN': {
                        'GatewayEuiEventTopic': 'Enabled'|'Disabled'
                    },
                    'WirelessGatewayIdEventTopic': 'Enabled'|'Disabled'
                }
            }
        },
    ]
}

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.

    • EventConfigurationsList (list) --

      Event configurations of all events for a single resource.

      • (dict) --

        Event configuration object for a single resource.

        • Identifier (string) --

          Resource identifier opted in for event messaging.

        • IdentifierType (string) --

          Identifier type of the particular resource identifier for event configuration.

        • PartnerType (string) --

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

        • Events (dict) --

          Object of all event configurations and the status of the event topics.

          • DeviceRegistrationState (dict) --

            Device registration state event configuration for an event configuration item.

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

            • WirelessDeviceIdEventTopic (string) --

              Enum to denote whether the wireless device id device registration state event topic is enabled or disabled.

          • Proximity (dict) --

            Proximity event configuration for an event configuration item.

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

            • WirelessDeviceIdEventTopic (string) --

              Enum to denote whether the wireless device id proximity event topic is enabled or disabled.

          • Join (dict) --

            Join event configuration for an event configuration item.

            • LoRaWAN (dict) --

              Join event configuration object for enabling or disabling LoRaWAN related event topics.

              • DevEuiEventTopic (string) --

                Enum to denote whether the dev eui join event topic is enabled or disabled.

            • WirelessDeviceIdEventTopic (string) --

              Enum to denote whether the wireless device id join event topic is enabled or disabled.

          • ConnectionStatus (dict) --

            Connection status event configuration for an event configuration item.

            • LoRaWAN (dict) --

              Connection status event configuration object for enabling or disabling LoRaWAN related event topics.

              • GatewayEuiEventTopic (string) --

                Enum to denote whether the gateway eui connection status event topic is enabled or disabled.

            • WirelessGatewayIdEventTopic (string) --

              Enum to denote whether the wireless gateway id connection status event topic is enabled or disabled .

DeleteNetworkAnalyzerConfiguration (new) Link ¶

Deletes a network analyzer configuration.

See also: AWS API Documentation

Request Syntax

client.delete_network_analyzer_configuration(
    ConfigurationName='string'
)
type ConfigurationName:

string

param ConfigurationName:

[REQUIRED]

Name of the network analyzer configuration.

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --

CreateWirelessDevice (updated) Link ¶
Changes (request)
{'LoRaWAN': {'AbpV1_0_x': {'FCntStart': 'integer'},
             'AbpV1_1': {'FCntStart': 'integer'}}}

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'
            },
            'FCntStart': 123
        },
        'AbpV1_0_x': {
            'DevAddr': 'string',
            'SessionKeys': {
                'NwkSKey': 'string',
                'AppSKey': 'string'
            },
            'FCntStart': 123
        },
        '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.

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

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.

GetNetworkAnalyzerConfiguration (updated) Link ¶
Changes (response)
{'Arn': 'string', 'Description': 'string', 'Name': 'string'}

Get network analyzer configuration.

See also: AWS API Documentation

Request Syntax

client.get_network_analyzer_configuration(
    ConfigurationName='string'
)
type ConfigurationName:

string

param ConfigurationName:

[REQUIRED]

Name of the network analyzer configuration.

rtype:

dict

returns:

Response Syntax

{
    'TraceContent': {
        'WirelessDeviceFrameInfo': 'ENABLED'|'DISABLED',
        'LogLevel': 'INFO'|'ERROR'|'DISABLED'
    },
    'WirelessDevices': [
        'string',
    ],
    'WirelessGateways': [
        'string',
    ],
    'Description': 'string',
    'Arn': 'string',
    'Name': 'string'
}

Response Structure

  • (dict) --

    • TraceContent (dict) --

      Trace content for your wireless gateway and wireless device resources.

      • WirelessDeviceFrameInfo (string) --

        FrameInfo of your wireless device resources for the trace content. Use FrameInfo to debug the communication between your LoRaWAN end devices and the network server.

      • LogLevel (string) --

        The log level for a log message. The log levels can be disabled, or set to ERROR to display less verbose logs containing only error information, or to INFO for more detailed logs.

    • WirelessDevices (list) --

      List of wireless gateway resources that have been added to the network analyzer configuration.

      • (string) --

        The ID of the wireless device.

    • WirelessGateways (list) --

      List of wireless gateway resources that have been added to the network analyzer configuration.

      • (string) --

    • Description (string) --

      The description of the new resource.

    • Arn (string) --

      The Amazon Resource Name of the new resource.

    • Name (string) --

      Name of the network analyzer configuration.

GetResourceEventConfiguration (updated) Link ¶
Changes (request, response)
Request
{'IdentifierType': {'DevEui',
                    'GatewayEui',
                    'WirelessDeviceId',
                    'WirelessGatewayId'}}
Response
{'ConnectionStatus': {'LoRaWAN': {'GatewayEuiEventTopic': 'Enabled | Disabled'},
                      'WirelessGatewayIdEventTopic': 'Enabled | Disabled'},
 'DeviceRegistrationState': {'WirelessDeviceIdEventTopic': 'Enabled | '
                                                           'Disabled'},
 'Join': {'LoRaWAN': {'DevEuiEventTopic': 'Enabled | Disabled'},
          'WirelessDeviceIdEventTopic': 'Enabled | Disabled'},
 'Proximity': {'WirelessDeviceIdEventTopic': 'Enabled | Disabled'}}

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'|'DevEui'|'GatewayEui'|'WirelessDeviceId'|'WirelessGatewayId',
    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'
        },
        'WirelessDeviceIdEventTopic': 'Enabled'|'Disabled'
    },
    'Proximity': {
        'Sidewalk': {
            'AmazonIdEventTopic': 'Enabled'|'Disabled'
        },
        'WirelessDeviceIdEventTopic': 'Enabled'|'Disabled'
    },
    'Join': {
        'LoRaWAN': {
            'DevEuiEventTopic': 'Enabled'|'Disabled'
        },
        'WirelessDeviceIdEventTopic': 'Enabled'|'Disabled'
    },
    'ConnectionStatus': {
        'LoRaWAN': {
            'GatewayEuiEventTopic': 'Enabled'|'Disabled'
        },
        'WirelessGatewayIdEventTopic': '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.

      • WirelessDeviceIdEventTopic (string) --

        Enum to denote whether the wireless device id device registration state 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.

      • WirelessDeviceIdEventTopic (string) --

        Enum to denote whether the wireless device id proximity event topic is enabled or disabled.

    • Join (dict) --

      Event configuration for the join event.

      • LoRaWAN (dict) --

        Join event configuration object for enabling or disabling LoRaWAN related event topics.

        • DevEuiEventTopic (string) --

          Enum to denote whether the dev eui join event topic is enabled or disabled.

      • WirelessDeviceIdEventTopic (string) --

        Enum to denote whether the wireless device id join event topic is enabled or disabled.

    • ConnectionStatus (dict) --

      Event configuration for the connection status event.

      • LoRaWAN (dict) --

        Connection status event configuration object for enabling or disabling LoRaWAN related event topics.

        • GatewayEuiEventTopic (string) --

          Enum to denote whether the gateway eui connection status event topic is enabled or disabled.

      • WirelessGatewayIdEventTopic (string) --

        Enum to denote whether the wireless gateway id connection status event topic is enabled or disabled .

GetWirelessDevice (updated) Link ¶
Changes (response)
{'LoRaWAN': {'AbpV1_0_x': {'FCntStart': 'integer'},
             'AbpV1_1': {'FCntStart': 'integer'}}}

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'
            },
            'FCntStart': 123
        },
        'AbpV1_0_x': {
            'DevAddr': 'string',
            'SessionKeys': {
                'NwkSKey': 'string',
                'AppSKey': 'string'
            },
            'FCntStart': 123
        },
        '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.

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

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

UpdateNetworkAnalyzerConfiguration (updated) Link ¶
Changes (request)
{'Description': 'string'}

Update network analyzer configuration.

See also: AWS API Documentation

Request Syntax

client.update_network_analyzer_configuration(
    ConfigurationName='string',
    TraceContent={
        'WirelessDeviceFrameInfo': 'ENABLED'|'DISABLED',
        'LogLevel': 'INFO'|'ERROR'|'DISABLED'
    },
    WirelessDevicesToAdd=[
        'string',
    ],
    WirelessDevicesToRemove=[
        'string',
    ],
    WirelessGatewaysToAdd=[
        'string',
    ],
    WirelessGatewaysToRemove=[
        'string',
    ],
    Description='string'
)
type ConfigurationName:

string

param ConfigurationName:

[REQUIRED]

Name of the network analyzer configuration.

type TraceContent:

dict

param TraceContent:

Trace content for your wireless gateway and wireless device resources.

  • WirelessDeviceFrameInfo (string) --

    FrameInfo of your wireless device resources for the trace content. Use FrameInfo to debug the communication between your LoRaWAN end devices and the network server.

  • LogLevel (string) --

    The log level for a log message. The log levels can be disabled, or set to ERROR to display less verbose logs containing only error information, or to INFO for more detailed logs.

type WirelessDevicesToAdd:

list

param WirelessDevicesToAdd:

Wireless device resources to add to the network analyzer configuration. Provide the WirelessDeviceId of the resource to add in the input array.

  • (string) --

    The ID of the wireless device.

type WirelessDevicesToRemove:

list

param WirelessDevicesToRemove:

Wireless device resources to remove from the network analyzer configuration. Provide the WirelessDeviceId of the resources to remove in the input array.

  • (string) --

    The ID of the wireless device.

type WirelessGatewaysToAdd:

list

param WirelessGatewaysToAdd:

Wireless gateway resources to add to the network analyzer configuration. Provide the WirelessGatewayId of the resource to add in the input array.

  • (string) --

type WirelessGatewaysToRemove:

list

param WirelessGatewaysToRemove:

Wireless gateway resources to remove from the network analyzer configuration. Provide the WirelessGatewayId of the resources to remove in the input array.

  • (string) --

type Description:

string

param Description:

The description of the new resource.

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --

UpdateResourceEventConfiguration (updated) Link ¶
Changes (request)
{'ConnectionStatus': {'LoRaWAN': {'GatewayEuiEventTopic': 'Enabled | Disabled'},
                      'WirelessGatewayIdEventTopic': 'Enabled | Disabled'},
 'DeviceRegistrationState': {'WirelessDeviceIdEventTopic': 'Enabled | '
                                                           'Disabled'},
 'IdentifierType': {'DevEui',
                    'GatewayEui',
                    'WirelessDeviceId',
                    'WirelessGatewayId'},
 'Join': {'LoRaWAN': {'DevEuiEventTopic': 'Enabled | Disabled'},
          'WirelessDeviceIdEventTopic': 'Enabled | Disabled'},
 'Proximity': {'WirelessDeviceIdEventTopic': 'Enabled | Disabled'}}

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'|'DevEui'|'GatewayEui'|'WirelessDeviceId'|'WirelessGatewayId',
    PartnerType='Sidewalk',
    DeviceRegistrationState={
        'Sidewalk': {
            'AmazonIdEventTopic': 'Enabled'|'Disabled'
        },
        'WirelessDeviceIdEventTopic': 'Enabled'|'Disabled'
    },
    Proximity={
        'Sidewalk': {
            'AmazonIdEventTopic': 'Enabled'|'Disabled'
        },
        'WirelessDeviceIdEventTopic': 'Enabled'|'Disabled'
    },
    Join={
        'LoRaWAN': {
            'DevEuiEventTopic': 'Enabled'|'Disabled'
        },
        'WirelessDeviceIdEventTopic': 'Enabled'|'Disabled'
    },
    ConnectionStatus={
        'LoRaWAN': {
            'GatewayEuiEventTopic': 'Enabled'|'Disabled'
        },
        'WirelessGatewayIdEventTopic': '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.

  • WirelessDeviceIdEventTopic (string) --

    Enum to denote whether the wireless device id device registration state 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.

  • WirelessDeviceIdEventTopic (string) --

    Enum to denote whether the wireless device id proximity event topic is enabled or disabled.

type Join:

dict

param Join:

Event configuration for the join event

  • LoRaWAN (dict) --

    Join event configuration object for enabling or disabling LoRaWAN related event topics.

    • DevEuiEventTopic (string) --

      Enum to denote whether the dev eui join event topic is enabled or disabled.

  • WirelessDeviceIdEventTopic (string) --

    Enum to denote whether the wireless device id join event topic is enabled or disabled.

type ConnectionStatus:

dict

param ConnectionStatus:

Event configuration for the connection status event

  • LoRaWAN (dict) --

    Connection status event configuration object for enabling or disabling LoRaWAN related event topics.

    • GatewayEuiEventTopic (string) --

      Enum to denote whether the gateway eui connection status event topic is enabled or disabled.

  • WirelessGatewayIdEventTopic (string) --

    Enum to denote whether the wireless gateway id connection status event topic is enabled or disabled .

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --

UpdateWirelessDevice (updated) Link ¶
Changes (request)
{'LoRaWAN': {'AbpV1_0_x': {'FCntStart': 'integer'},
             'AbpV1_1': {'FCntStart': 'integer'}}}

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
        }
    }
)
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.

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --