:doc:`Greengrass <../../greengrass>` / Client / list_groups

***********
list_groups
***********



.. py:method:: Greengrass.Client.list_groups(**kwargs)

  Retrieves a list of groups.

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/greengrass-2017-06-07/ListGroups>`_  


  **Request Syntax**
  ::

    response = client.list_groups(
        MaxResults='string',
        NextToken='string'
    )
    
  :type MaxResults: string
  :param MaxResults: The maximum number of results to be returned per request.

  
  :type NextToken: string
  :param NextToken: The token for the next set of results, or ''null'' if there are no additional results.

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

    
    ::

      {
          'Groups': [
              {
                  'Arn': 'string',
                  'CreationTimestamp': 'string',
                  'Id': 'string',
                  'LastUpdatedTimestamp': 'string',
                  'LatestVersion': 'string',
                  'LatestVersionArn': 'string',
                  'Name': 'string'
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Groups** *(list) --* Information about a group.
        

        - *(dict) --* Information about a group.
          

          - **Arn** *(string) --* The ARN of the group.
          

          - **CreationTimestamp** *(string) --* The time, in milliseconds since the epoch, when the group was created.
          

          - **Id** *(string) --* The ID of the group.
          

          - **LastUpdatedTimestamp** *(string) --* The time, in milliseconds since the epoch, when the group was last updated.
          

          - **LatestVersion** *(string) --* The ID of the latest version associated with the group.
          

          - **LatestVersionArn** *(string) --* The ARN of the latest version associated with the group.
          

          - **Name** *(string) --* The name of the group.
      
    
      

      - **NextToken** *(string) --* The token for the next set of results, or ''null'' if there are no additional results.
  