list_user_pools

CognitoIdentityProvider.Client.list_user_pools(**kwargs)

Lists the user pools associated with an Amazon Web Services account.

See also: AWS API Documentation

Request Syntax

response = client.list_user_pools(
    NextToken='string',
    MaxResults=123
)

Parameters

• NextToken (string) -- An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.
• MaxResults (integer) --

  [REQUIRED]

  The maximum number of results you want the request to return when listing the user pools.

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)
        },
    ],
    'NextToken': 'string'
}

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.

  • NextToken (string) --

    An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

Exceptions

• CognitoIdentityProvider.Client.exceptions.InvalidParameterException
• CognitoIdentityProvider.Client.exceptions.TooManyRequestsException
• CognitoIdentityProvider.Client.exceptions.NotAuthorizedException
• CognitoIdentityProvider.Client.exceptions.InternalErrorException