:doc:`ManagedintegrationsforIoTDeviceManagement <../../iot-managed-integrations>` / Client / list_managed_things

*******************
list_managed_things
*******************



.. py:method:: ManagedintegrationsforIoTDeviceManagement.Client.list_managed_things(**kwargs)

  

  Listing all managed things with provision for filters.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iot-managed-integrations-2025-03-03/ListManagedThings>`_  


  **Request Syntax**
  ::

    response = client.list_managed_things(
        OwnerFilter='string',
        CredentialLockerFilter='string',
        RoleFilter='CONTROLLER'|'DEVICE',
        ParentControllerIdentifierFilter='string',
        ConnectorPolicyIdFilter='string',
        ConnectorDestinationIdFilter='string',
        ConnectorDeviceIdFilter='string',
        SerialNumberFilter='string',
        ProvisioningStatusFilter='UNASSOCIATED'|'PRE_ASSOCIATED'|'DISCOVERED'|'ACTIVATED'|'DELETION_FAILED'|'DELETE_IN_PROGRESS'|'ISOLATED'|'DELETED',
        NextToken='string',
        MaxResults=123
    )
    
  :type OwnerFilter: string
  :param OwnerFilter: 

    Filter on device owners when listing managed things.

    

  
  :type CredentialLockerFilter: string
  :param CredentialLockerFilter: 

    Filter on a credential locker for a managed thing.

    

  
  :type RoleFilter: string
  :param RoleFilter: 

    Filter on the type of device used. This will be the Amazon Web Services hub controller, cloud device, or IoT device.

    

  
  :type ParentControllerIdentifierFilter: string
  :param ParentControllerIdentifierFilter: 

    Filter on a parent controller id for a managed thing.

    

  
  :type ConnectorPolicyIdFilter: string
  :param ConnectorPolicyIdFilter: 

    Filter on a connector policy id for a managed thing.

    

  
  :type ConnectorDestinationIdFilter: string
  :param ConnectorDestinationIdFilter: 

    Filter managed things by the connector destination ID they are associated with.

    

  
  :type ConnectorDeviceIdFilter: string
  :param ConnectorDeviceIdFilter: 

    Filter managed things by the connector device ID they are associated with. When specified, only managed things with this connector device ID will be returned.

    

  
  :type SerialNumberFilter: string
  :param SerialNumberFilter: 

    Filter on the serial number of the device.

    

  
  :type ProvisioningStatusFilter: string
  :param ProvisioningStatusFilter: 

    Filter on the status of the device. For more information, see `Device Provisioning <https://docs.aws.amazon.com/iot-mi/latest/devguide/device-provisioning.html>`__.

    

  
  :type NextToken: string
  :param NextToken: 

    A token that can be used to retrieve the next set of results.

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of results to return at one time.

    

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

    
    ::

      {
          'Items': [
              {
                  'Id': 'string',
                  'Arn': 'string',
                  'AdvertisedProductId': 'string',
                  'Brand': 'string',
                  'Classification': 'string',
                  'ConnectorDeviceId': 'string',
                  'ConnectorPolicyId': 'string',
                  'ConnectorDestinationId': 'string',
                  'Model': 'string',
                  'Name': 'string',
                  'Owner': 'string',
                  'CredentialLockerId': 'string',
                  'ParentControllerId': 'string',
                  'ProvisioningStatus': 'UNASSOCIATED'|'PRE_ASSOCIATED'|'DISCOVERED'|'ACTIVATED'|'DELETION_FAILED'|'DELETE_IN_PROGRESS'|'ISOLATED'|'DELETED',
                  'Role': 'CONTROLLER'|'DEVICE',
                  'SerialNumber': 'string',
                  'CreatedAt': datetime(2015, 1, 1),
                  'UpdatedAt': datetime(2015, 1, 1),
                  'ActivatedAt': datetime(2015, 1, 1)
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Items** *(list) --* 

        The list of managed things.

        
        

        - *(dict) --* 

          Structure representing one managed thing.

          
          

          - **Id** *(string) --* 

            The id of the device.

            
          

          - **Arn** *(string) --* 

            The Amazon Resource Name (ARN) of the managed thing.

            
          

          - **AdvertisedProductId** *(string) --* 

            The id of the advertised product.

            
          

          - **Brand** *(string) --* 

            The brand of the device.

            
          

          - **Classification** *(string) --* 

            The classification of the managed thing such as light bulb or thermostat.

            
          

          - **ConnectorDeviceId** *(string) --* 

            The third-party device id as defined by the connector. This device id must not contain personal identifiable information (PII).

             

            .. note::

              

              This parameter is used for cloud-to-cloud devices only.

              

            
          

          - **ConnectorPolicyId** *(string) --* 

            The id of the connector policy.

             

            .. note::

              

              This parameter is used for cloud-to-cloud devices only.

              

            
          

          - **ConnectorDestinationId** *(string) --* 

            The identifier of the connector destination associated with this managed thing, if applicable.

            
          

          - **Model** *(string) --* 

            The model of the device.

            
          

          - **Name** *(string) --* 

            The name of the managed thing representing the physical device.

            
          

          - **Owner** *(string) --* 

            Owner of the device, usually an indication of whom the device belongs to. This value should not contain personal identifiable information.

            
          

          - **CredentialLockerId** *(string) --* 

            The identifier of the credential locker for the managed thing.

            
          

          - **ParentControllerId** *(string) --* 

            Id of the controller device used for the discovery job.

            
          

          - **ProvisioningStatus** *(string) --* 

            The provisioning status of the device in the provisioning workflow for onboarding to IoT managed integrations. For more information, see `Device Provisioning <https://docs.aws.amazon.com/iot-mi/latest/devguide/device-provisioning.html>`__.

            
          

          - **Role** *(string) --* 

            The type of device used. This will be the Amazon Web Services hub controller, cloud device, or IoT device.

            
          

          - **SerialNumber** *(string) --* 

            The serial number of the device.

            
          

          - **CreatedAt** *(datetime) --* 

            The timestamp value of when the device creation request occurred.

            
          

          - **UpdatedAt** *(datetime) --* 

            The timestamp value of when the managed thing was last updated at.

            
          

          - **ActivatedAt** *(datetime) --* 

            The timestampe value of when the managed thing was activated at.

            
      
    
      

      - **NextToken** *(string) --* 

        A token that can be used to retrieve the next set of results.

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

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

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

  
  *   :py:class:`ManagedintegrationsforIoTDeviceManagement.Client.exceptions.UnauthorizedException`

  
  *   :py:class:`ManagedintegrationsforIoTDeviceManagement.Client.exceptions.ServiceUnavailableException`

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

  