CognitoIdentityProvider / Paginator / ListUserPools

ListUserPools#

class CognitoIdentityProvider.Paginator.ListUserPools#
paginator = client.get_paginator('list_user_pools')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from CognitoIdentityProvider.Client.list_user_pools().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:

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

{
    'UserPools': [
        {
            'Id': 'string',
            'Name': 'string',
            'LambdaConfig': {
                'PreSignUp': 'string',
                'CustomMessage': 'string',
                'PostConfirmation': 'string',
                'PreAuthentication': 'string',
                'PostAuthentication': 'string',
                'DefineAuthChallenge': 'string',
                'CreateAuthChallenge': 'string',
                'VerifyAuthChallengeResponse': 'string',
                'PreTokenGeneration': 'string',
                'UserMigration': 'string',
                'CustomSMSSender': {
                    'LambdaVersion': 'V1_0',
                    'LambdaArn': 'string'
                },
                'CustomEmailSender': {
                    'LambdaVersion': 'V1_0',
                    'LambdaArn': 'string'
                },
                'KMSKeyID': 'string'
            },
            'Status': 'Enabled'|'Disabled',
            'LastModifiedDate': datetime(2015, 1, 1),
            'CreationDate': datetime(2015, 1, 1)
        },
    ],

}

Response Structure

  • (dict) –

    Represents the response to list user pools.

    • UserPools (list) –

      The user pools from the response to list users.

      • (dict) –

        A user pool description.

        • Id (string) –

          The ID in a user pool description.

        • Name (string) –

          The name in a user pool description.

        • LambdaConfig (dict) –

          The Lambda configuration information in a user pool description.

          • PreSignUp (string) –

            A pre-registration Lambda trigger.

          • CustomMessage (string) –

            A custom Message Lambda trigger.

          • PostConfirmation (string) –

            A post-confirmation Lambda trigger.

          • PreAuthentication (string) –

            A pre-authentication Lambda trigger.

          • PostAuthentication (string) –

            A post-authentication Lambda trigger.

          • DefineAuthChallenge (string) –

            Defines the authentication challenge.

          • CreateAuthChallenge (string) –

            Creates an authentication challenge.

          • VerifyAuthChallengeResponse (string) –

            Verifies the authentication challenge response.

          • PreTokenGeneration (string) –

            A Lambda trigger that is invoked before token generation.

          • UserMigration (string) –

            The user migration Lambda config type.

          • CustomSMSSender (dict) –

            A custom SMS sender Lambda trigger.

            • LambdaVersion (string) –

              Signature of the “request” attribute in the “event” information that Amazon Cognito passes to your custom SMS Lambda function. The only supported value is V1_0.

            • LambdaArn (string) –

              The Amazon Resource Name (ARN) of the Lambda function that Amazon Cognito activates to send SMS notifications to users.

          • CustomEmailSender (dict) –

            A custom email sender Lambda trigger.

            • LambdaVersion (string) –

              Signature of the “request” attribute in the “event” information Amazon Cognito passes to your custom email Lambda function. The only supported value is V1_0.

            • LambdaArn (string) –

              The Amazon Resource Name (ARN) of the Lambda function that Amazon Cognito activates to send email notifications to users.

          • KMSKeyID (string) –

            The Amazon Resource Name (ARN) of an KMS key. Amazon Cognito uses the key to encrypt codes and temporary passwords sent to CustomEmailSender and CustomSMSSender.

        • Status (string) –

          The user pool status in a user pool description.

        • LastModifiedDate (datetime) –

          The date the user pool description was last modified.

        • CreationDate (datetime) –

          The date the user pool description was created.