IdentityStore / Paginator / ListGroups

ListGroups

class IdentityStore.Paginator.ListGroups

paginator = client.get_paginator('list_groups')

paginate(**kwargs)

Creates an iterator that will paginate through responses from IdentityStore.Client.list_groups().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    IdentityStoreId='string',
    Filters=[
        {
            'AttributePath': 'string',
            'AttributeValue': 'string'
        },
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

• IdentityStoreId (string) –

  [REQUIRED]

  The globally unique identifier for the identity store, such as d-1234567890. In this example, d- is a fixed prefix, and 1234567890 is a randomly generated string that contains numbers and lower case letters. This value is generated at the time that a new identity store is created.

• Filters (list) –

  A list of Filter objects, which is used in the ListUsers and ListGroups requests.

  • (dict) –

    A query filter used by ListUsers and ListGroups. This filter object provides the attribute name and attribute value to search users or groups.

    • AttributePath (string) – [REQUIRED]

      The attribute path that is used to specify which attribute name to search. Length limit is 255 characters. For example, UserName is a valid attribute path for the ListUsers API, and DisplayName is a valid attribute path for the ListGroups API.

    • AttributeValue (string) – [REQUIRED]

      Represents the data for an attribute. Each attribute value is described as a name-value pair.

• PaginationConfig (dict) –

  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.

Return type:

dict

Returns:

Response Syntax

{
    'Groups': [
        {
            'GroupId': 'string',
            'DisplayName': 'string',
            'ExternalIds': [
                {
                    'Issuer': 'string',
                    'Id': 'string'
                },
            ],
            'Description': 'string',
            'IdentityStoreId': 'string'
        },
    ],

}

Response Structure

• (dict) –

  • Groups (list) –

    A list of Group objects in the identity store.

    • (dict) –

      A group object that contains a specified group’s metadata and attributes.

      • GroupId (string) –

        The identifier for a group in the identity store.

      • DisplayName (string) –

        The group’s display name value. The length limit is 1,024 characters. This value can consist of letters, accented characters, symbols, numbers, punctuation, tab, new line, carriage return, space, and nonbreaking space in this attribute. This value is specified at the time the group is created and stored as an attribute of the group object in the identity store.

      • ExternalIds (list) –

        A list of ExternalId objects that contains the identifiers issued to this resource by an external identity provider.

        • (dict) –

          The identifier issued to this resource by an external identity provider.

          • Issuer (string) –

            The issuer for an external identifier.

          • Id (string) –

            The identifier issued to this resource by an external identity provider.

      • Description (string) –

        A string containing a description of the specified group.

      • IdentityStoreId (string) –

        The globally unique identifier for the identity store.