:doc:`IoTWireless <../../iotwireless>` / Client / list_wireless_devices

*********************
list_wireless_devices
*********************



.. py:method:: IoTWireless.Client.list_wireless_devices(**kwargs)

  

  Lists the wireless devices registered to your AWS account.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iotwireless-2020-11-22/ListWirelessDevices>`_  


  **Request Syntax**
  ::

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

             

            .. note::

              

              Theis value is only valid for 3 months.

              

            
          

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

            
      
    
  
  **Exceptions**
  
  *   :py:class:`IoTWireless.Client.exceptions.ValidationException`

  
  *   :py:class:`IoTWireless.Client.exceptions.InternalServerException`

  
  *   :py:class:`IoTWireless.Client.exceptions.ThrottlingException`

  
  *   :py:class:`IoTWireless.Client.exceptions.AccessDeniedException`

  