:doc:`Rekognition <../../rekognition>` / Client / list_users

**********
list_users
**********



.. py:method:: Rekognition.Client.list_users(**kwargs)

  

  Returns metadata of the User such as ``UserID`` in the specified collection. Anonymous User (to reserve faces without any identity) is not returned as part of this request. The results are sorted by system generated primary key ID. If the response is truncated, ``NextToken`` is returned in the response that can be used in the subsequent request to retrieve the next set of identities.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/rekognition-2016-06-27/ListUsers>`_  


  **Request Syntax**
  ::

    response = client.list_users(
        CollectionId='string',
        MaxResults=123,
        NextToken='string'
    )
    
  :type CollectionId: string
  :param CollectionId: **[REQUIRED]** 

    The ID of an existing collection.

    

  
  :type MaxResults: integer
  :param MaxResults: 

    Maximum number of UsersID to return.

    

  
  :type NextToken: string
  :param NextToken: 

    Pagingation token to receive the next set of UsersID.

    

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

    
    ::

      {
          'Users': [
              {
                  'UserId': 'string',
                  'UserStatus': 'ACTIVE'|'UPDATING'|'CREATING'|'CREATED'
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Users** *(list) --* 

        List of UsersID associated with the specified collection.

        
        

        - *(dict) --* 

          Metadata of the user stored in a collection.

          
          

          - **UserId** *(string) --* 

            A provided ID for the User. Unique within the collection.

            
          

          - **UserStatus** *(string) --* 

            Communicates if the UserID has been updated with latest set of faces to be associated with the UserID.

            
      
    
      

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

        A pagination token to be used with the subsequent request if the response is truncated.

        
  
  **Exceptions**
  
  *   :py:class:`Rekognition.Client.exceptions.InvalidParameterException`

  
  *   :py:class:`Rekognition.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`Rekognition.Client.exceptions.InvalidPaginationTokenException`

  
  *   :py:class:`Rekognition.Client.exceptions.ProvisionedThroughputExceededException`

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

  
  *   :py:class:`Rekognition.Client.exceptions.InternalServerError`

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

  