:doc:`SnowDeviceManagement <../../snow-device-management>` / Client / list_devices

************
list_devices
************



.. py:method:: SnowDeviceManagement.Client.list_devices(**kwargs)

  

  Returns a list of all devices on your Amazon Web Services account that have Amazon Web Services Snow Device Management enabled in the Amazon Web Services Region where the command is run.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/snow-device-management-2021-08-04/ListDevices>`_  


  **Request Syntax**
  ::

    response = client.list_devices(
        jobId='string',
        maxResults=123,
        nextToken='string'
    )
    
  :type jobId: string
  :param jobId: 

    The ID of the job used to order the device.

    

  
  :type maxResults: integer
  :param maxResults: 

    The maximum number of devices to list per page.

    

  
  :type nextToken: string
  :param nextToken: 

    A pagination token to continue to the next page of results.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'devices': [
              {
                  'associatedWithJob': 'string',
                  'managedDeviceArn': 'string',
                  'managedDeviceId': 'string',
                  'tags': {
                      'string': 'string'
                  }
              },
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **devices** *(list) --* 

        A list of device structures that contain information about the device.

        
        

        - *(dict) --* 

          Identifying information about the device.

          
          

          - **associatedWithJob** *(string) --* 

            The ID of the job used to order the device.

            
          

          - **managedDeviceArn** *(string) --* 

            The Amazon Resource Name (ARN) of the device.

            
          

          - **managedDeviceId** *(string) --* 

            The ID of the device.

            
          

          - **tags** *(dict) --* 

            Optional metadata that you assign to a resource. You can use tags to categorize a resource in different ways, such as by purpose, owner, or environment.

            
            

            - *(string) --* 
              

              - *(string) --* 
        
      
      
    
      

      - **nextToken** *(string) --* 

        A pagination token to continue to the next page of devices.

        
  
  **Exceptions**
  
  *   :py:class:`SnowDeviceManagement.Client.exceptions.ThrottlingException`

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

  
  *   :py:class:`SnowDeviceManagement.Client.exceptions.ValidationException`

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

  