:doc:`QuickSight <../../quicksight>` / Paginator / ListGroups

**********
ListGroups
**********



.. py:class:: QuickSight.Paginator.ListGroups

  ::

    
    paginator = client.get_paginator('list_groups')

  
  

  .. py:method:: paginate(**kwargs)

    Creates an iterator that will paginate through responses from :py:meth:`QuickSight.Client.list_groups`.

    See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/quicksight-2018-04-01/ListGroups>`_    


    **Request Syntax**
    ::

      response_iterator = paginator.paginate(
          AwsAccountId='string',
          Namespace='string',
          PaginationConfig={
              'MaxItems': 123,
              'PageSize': 123,
              'StartingToken': 'string'
          }
      )
      
    :type AwsAccountId: string
    :param AwsAccountId: **[REQUIRED]** 

      The ID for the Amazon Web Services account that the group is in. Currently, you use the ID for the Amazon Web Services account that contains your Amazon Quick Sight account.

      

    
    :type Namespace: string
    :param Namespace: **[REQUIRED]** 

      The namespace that you want a list of groups from.

      

    
    :type PaginationConfig: dict
    :param PaginationConfig: 

      A dictionary that provides parameters to control pagination.

      

    
      - **MaxItems** *(integer) --* 

        The total number of items to return. If the total number of items available is more than the value specified in max-items then a ``NextToken`` will be provided in the output that you can use to resume pagination.

        

      
      - **PageSize** *(integer) --* 

        The size of each page.

        

      
      - **StartingToken** *(string) --* 

        A token to specify where to start paginating. This is the ``NextToken`` from a previous response.

        

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

      
      ::

        {
            'GroupList': [
                {
                    'Arn': 'string',
                    'GroupName': 'string',
                    'Description': 'string',
                    'PrincipalId': 'string'
                },
            ],
            'RequestId': 'string',
            'Status': 123
        }
        
      **Response Structure**

      

      - *(dict) --* 
        

        - **GroupList** *(list) --* 

          The list of the groups.

          
          

          - *(dict) --* 

            A *group* in Quick Sight consists of a set of users. You can use groups to make it easier to manage access and security.

            
            

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

              The Amazon Resource Name (ARN) for the group.

              
            

            - **GroupName** *(string) --* 

              The name of the group.

              
            

            - **Description** *(string) --* 

              The group description.

              
            

            - **PrincipalId** *(string) --* 

              The principal ID of the group.

              
        
      
        

        - **RequestId** *(string) --* 

          The Amazon Web Services request ID for this operation.

          
        

        - **Status** *(integer) --* 

          The HTTP status of the request.

          
    