Sample code for 30+ languages & platforms
Java

Amazon Cognito - Describe User Pool

See more Amazon Cognito Examples

Returns the configuration information and metadata of the specified user pool.

Chilkat Java Downloads

Chilkat2 Java
import com.chilkatsoft.chilkat2.AuthAws;
import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.JsonObject;
import com.chilkatsoft.chilkat2.Rest;
import com.chilkatsoft.chilkat2.StringBuilder;

public class ChilkatExample {

    public static void main(String[] args) {
        // This example requires the Chilkat API to have been previously unlocked.
        // See Global Unlock Sample for sample code.

        Rest rest = new Rest();

        AuthAws authAws = new AuthAws();
        authAws.setAccessKey("AWS_ACCESS_KEY");
        authAws.setSecretKey("AWS_SECRET_KEY");
        // Don't forget to change the region to your particular region. (Also make the same change in the call to Connect below.)
        authAws.setRegion("us-west-2");
        authAws.setServiceName("cognito-idp");
        // SetAuthAws causes Chilkat to automatically add the following headers: Authorization, X-Amz-Date
        rest.setAuthAws(authAws);

        // URL: https://cognito-idp.us-west-2.amazonaws.com/
        boolean bTls = true;
        int port = 443;
        boolean bAutoReconnect = true;
        // Use the same region as specified above.
        try {
            rest.connect("cognito-idp.us-west-2.amazonaws.com", port, bTls, bAutoReconnect);
        } catch (ChilkatException e) {
            System.out.println("ConnectFailReason: " + rest.getConnectFailReason());
            System.out.println(e.getLastErrorText());
            return;
        }

        // Note: The above code does not need to be repeatedly called for each REST request.
        // The rest object can be setup once, and then many requests can be sent.  Chilkat will automatically
        // reconnect within a FullRequest* method as needed.  It is only the very first connection that is explicitly
        // made via the Connect method.

        JsonObject json = new JsonObject();
        json.updateString("UserPoolId", "us-west-2_yt6WzO3SA");

        rest.addHeader("Content-Type", "application/x-amz-json-1.0");
        rest.addHeader("X-Amz-Target", "AWSCognitoIdentityProviderService.DescribeUserPool");
        rest.addHeader("Accept-Encoding", "identity");

        StringBuilder sbRequestBody = new StringBuilder();
        json.emitSb(sbRequestBody);
        StringBuilder sbResponseBody = new StringBuilder();
        try {
            rest.fullRequestSb("POST", "/", sbRequestBody, sbResponseBody);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        int respStatusCode = rest.getResponseStatusCode();
        System.out.println("response status code = " + respStatusCode);
        if (respStatusCode != 200) {
            System.out.println("Response Status Code = " + respStatusCode);
            System.out.println("Response Header:");
            System.out.println(rest.getResponseHeader());
            System.out.println("Response Body:");
            System.out.println(sbResponseBody.getAsString());
            return;
        }

        JsonObject jsonResponse = new JsonObject();
        jsonResponse.loadSb(sbResponseBody);

        jsonResponse.setEmitCompact(false);
        System.out.println(jsonResponse.emit());

        // Sample JSON response:
        // (Sample code for parsing the JSON response is shown below)

        // Use this online tool to generate parsing code from sample JSON:
        // Generate Parsing Code from JSON

        // {
        //   "UserPool": {
        //     "AccountRecoverySetting": {
        //       "RecoveryMechanisms": [
        //         {
        //           "Name": "verified_phone_number",
        //           "Priority": 1
        //         },
        //         {
        //           "Name": "verified_email",
        //           "Priority": 2
        //         }
        //       ]
        //     },
        //     "AdminCreateUserConfig": {
        //       "AllowAdminCreateUserOnly": false,
        //       "InviteMessageTemplate": {
        //         "EmailMessage": "Your username is {username} and temporary password is {####}. ",
        //         "EmailSubject": "Your temporary password",
        //         "SMSMessage": "Your username is {username} and temporary password is {####}. "
        //       },
        //       "UnusedAccountValidityDays": 7
        //     },
        //     "Arn": "arn:aws:cognito-idp:us-west-2:954491834127:userpool/us-west-2_yt6WzO3SA",
        //     "AutoVerifiedAttributes": [
        //       "email",
        //       "phone_number"
        //     ],
        //     "CreationDate": 1.636388909817E9,
        //     "EmailConfiguration": {
        //       "EmailSendingAccount": "DEVELOPER",
        //       "From": "admin@chilkatsoft.com",
        //       "ReplyToEmailAddress": "admin@chilkatsoft.com",
        //       "SourceArn": "arn:aws:ses:us-west-2:954491834127:identity/admin@chilkatsoft.com"
        //     },
        //     "EmailVerificationMessage": "Your verification code is {####}. ",
        //     "EmailVerificationSubject": "Your verification code",
        //     "EstimatedNumberOfUsers": 0,
        //     "Id": "us-west-2_yt6WzO3SA",
        //     "LambdaConfig": {},
        //     "LastModifiedDate": 1.636388910377E9,
        //     "MfaConfiguration": "ON",
        //     "Name": "chilkat",
        //     "Policies": {
        //       "PasswordPolicy": {
        //         "MinimumLength": 8,
        //         "RequireLowercase": true,
        //         "RequireNumbers": true,
        //         "RequireSymbols": true,
        //         "RequireUppercase": true,
        //         "TemporaryPasswordValidityDays": 7
        //       }
        //     },
        //     "SchemaAttributes": [
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": false,
        //         "Name": "sub",
        //         "Required": true,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "1"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "name",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "given_name",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "family_name",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "middle_name",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "nickname",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "preferred_username",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "profile",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "picture",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "website",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "email",
        //         "Required": true,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "Boolean",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "email_verified",
        //         "Required": false
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "gender",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "birthdate",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "10",
        //           "MinLength": "10"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "zoneinfo",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "locale",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "phone_number",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "Boolean",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "phone_number_verified",
        //         "Required": false
        //       },
        //       {
        //         "AttributeDataType": "String",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "address",
        //         "Required": false,
        //         "StringAttributeConstraints": {
        //           "MaxLength": "2048",
        //           "MinLength": "0"
        //         }
        //       },
        //       {
        //         "AttributeDataType": "Number",
        //         "DeveloperOnlyAttribute": false,
        //         "Mutable": true,
        //         "Name": "updated_at",
        //         "NumberAttributeConstraints": {
        //           "MinValue": "0"
        //         },
        //         "Required": false
        //       }
        //     ],
        //     "SmsAuthenticationMessage": "Your verification code is {####}. ",
        //     "SmsConfiguration": {
        //       "ExternalId": "94b17737-216b-4cf7-a29e-17e990e91300",
        //       "SnsCallerArn": "arn:aws:iam::954491834127:role/service-role/chilkat-SMS-Role"
        //     },
        //     "SmsVerificationMessage": "Your verification code is {####}. ",
        //     "UserPoolTags": {
        //       "sampleUserPoolTag": "test"
        //     },
        //     "UsernameConfiguration": {
        //       "CaseSensitive": false
        //     },
        //     "VerificationMessageTemplate": {
        //       "DefaultEmailOption": "CONFIRM_WITH_CODE",
        //       "EmailMessage": "Your verification code is {####}. ",
        //       "EmailSubject": "Your verification code",
        //       "SmsMessage": "Your verification code is {####}. "
        //     }
        //   }
        // }

        String Name = "";
        int Priority = 0;
        String strVal = "";
        String AttributeDataType = "";
        boolean DeveloperOnlyAttribute = false;
        boolean Mutable = false;
        boolean Required = false;
        String StringAttributeConstraintsMaxLength = "";
        String StringAttributeConstraintsMinLength = "";
        String NumberAttributeConstraintsMinValue = "";

        boolean UserPoolAdminCreateUserConfigAllowAdminCreateUserOnly = jsonResponse.boolOf("UserPool.AdminCreateUserConfig.AllowAdminCreateUserOnly");
        String UserPoolAdminCreateUserConfigInviteMessageTemplateEmailMessage = jsonResponse.stringOf("UserPool.AdminCreateUserConfig.InviteMessageTemplate.EmailMessage");
        String UserPoolAdminCreateUserConfigInviteMessageTemplateEmailSubject = jsonResponse.stringOf("UserPool.AdminCreateUserConfig.InviteMessageTemplate.EmailSubject");
        String UserPoolAdminCreateUserConfigInviteMessageTemplateSMSMessage = jsonResponse.stringOf("UserPool.AdminCreateUserConfig.InviteMessageTemplate.SMSMessage");
        int UserPoolAdminCreateUserConfigUnusedAccountValidityDays = jsonResponse.intOf("UserPool.AdminCreateUserConfig.UnusedAccountValidityDays");
        String UserPoolArn = jsonResponse.stringOf("UserPool.Arn");
        String UserPoolCreationDate = jsonResponse.stringOf("UserPool.CreationDate");
        String UserPoolEmailConfigurationEmailSendingAccount = jsonResponse.stringOf("UserPool.EmailConfiguration.EmailSendingAccount");
        String UserPoolEmailConfigurationFrom = jsonResponse.stringOf("UserPool.EmailConfiguration.From");
        String UserPoolEmailConfigurationReplyToEmailAddress = jsonResponse.stringOf("UserPool.EmailConfiguration.ReplyToEmailAddress");
        String UserPoolEmailConfigurationSourceArn = jsonResponse.stringOf("UserPool.EmailConfiguration.SourceArn");
        String UserPoolEmailVerificationMessage = jsonResponse.stringOf("UserPool.EmailVerificationMessage");
        String UserPoolEmailVerificationSubject = jsonResponse.stringOf("UserPool.EmailVerificationSubject");
        int UserPoolEstimatedNumberOfUsers = jsonResponse.intOf("UserPool.EstimatedNumberOfUsers");
        String UserPoolId = jsonResponse.stringOf("UserPool.Id");
        String UserPoolLastModifiedDate = jsonResponse.stringOf("UserPool.LastModifiedDate");
        String UserPoolMfaConfiguration = jsonResponse.stringOf("UserPool.MfaConfiguration");
        String UserPoolName = jsonResponse.stringOf("UserPool.Name");
        int UserPoolPoliciesPasswordPolicyMinimumLength = jsonResponse.intOf("UserPool.Policies.PasswordPolicy.MinimumLength");
        boolean UserPoolPoliciesPasswordPolicyRequireLowercase = jsonResponse.boolOf("UserPool.Policies.PasswordPolicy.RequireLowercase");
        boolean UserPoolPoliciesPasswordPolicyRequireNumbers = jsonResponse.boolOf("UserPool.Policies.PasswordPolicy.RequireNumbers");
        boolean UserPoolPoliciesPasswordPolicyRequireSymbols = jsonResponse.boolOf("UserPool.Policies.PasswordPolicy.RequireSymbols");
        boolean UserPoolPoliciesPasswordPolicyRequireUppercase = jsonResponse.boolOf("UserPool.Policies.PasswordPolicy.RequireUppercase");
        int UserPoolPoliciesPasswordPolicyTemporaryPasswordValidityDays = jsonResponse.intOf("UserPool.Policies.PasswordPolicy.TemporaryPasswordValidityDays");
        String UserPoolSmsAuthenticationMessage = jsonResponse.stringOf("UserPool.SmsAuthenticationMessage");
        String UserPoolSmsConfigurationExternalId = jsonResponse.stringOf("UserPool.SmsConfiguration.ExternalId");
        String UserPoolSmsConfigurationSnsCallerArn = jsonResponse.stringOf("UserPool.SmsConfiguration.SnsCallerArn");
        String UserPoolSmsVerificationMessage = jsonResponse.stringOf("UserPool.SmsVerificationMessage");
        String UserPoolUserPoolTagsSampleUserPoolTag = jsonResponse.stringOf("UserPool.UserPoolTags.sampleUserPoolTag");
        boolean UserPoolUsernameConfigurationCaseSensitive = jsonResponse.boolOf("UserPool.UsernameConfiguration.CaseSensitive");
        String UserPoolVerificationMessageTemplateDefaultEmailOption = jsonResponse.stringOf("UserPool.VerificationMessageTemplate.DefaultEmailOption");
        String UserPoolVerificationMessageTemplateEmailMessage = jsonResponse.stringOf("UserPool.VerificationMessageTemplate.EmailMessage");
        String UserPoolVerificationMessageTemplateEmailSubject = jsonResponse.stringOf("UserPool.VerificationMessageTemplate.EmailSubject");
        String UserPoolVerificationMessageTemplateSmsMessage = jsonResponse.stringOf("UserPool.VerificationMessageTemplate.SmsMessage");

        int i = 0;
        int count_i = jsonResponse.sizeOfArray("UserPool.AccountRecoverySetting.RecoveryMechanisms");
        while (i < count_i) {
            jsonResponse.setI(i);
            Name = jsonResponse.stringOf("UserPool.AccountRecoverySetting.RecoveryMechanisms[i].Name");
            Priority = jsonResponse.intOf("UserPool.AccountRecoverySetting.RecoveryMechanisms[i].Priority");
            i = i + 1;
        }

        i = 0;
        count_i = jsonResponse.sizeOfArray("UserPool.AutoVerifiedAttributes");
        while (i < count_i) {
            jsonResponse.setI(i);
            strVal = jsonResponse.stringOf("UserPool.AutoVerifiedAttributes[i]");
            i = i + 1;
        }

        i = 0;
        count_i = jsonResponse.sizeOfArray("UserPool.SchemaAttributes");
        while (i < count_i) {
            jsonResponse.setI(i);
            AttributeDataType = jsonResponse.stringOf("UserPool.SchemaAttributes[i].AttributeDataType");
            DeveloperOnlyAttribute = jsonResponse.boolOf("UserPool.SchemaAttributes[i].DeveloperOnlyAttribute");
            Mutable = jsonResponse.boolOf("UserPool.SchemaAttributes[i].Mutable");
            Name = jsonResponse.stringOf("UserPool.SchemaAttributes[i].Name");
            Required = jsonResponse.boolOf("UserPool.SchemaAttributes[i].Required");
            StringAttributeConstraintsMaxLength = jsonResponse.stringOf("UserPool.SchemaAttributes[i].StringAttributeConstraints.MaxLength");
            StringAttributeConstraintsMinLength = jsonResponse.stringOf("UserPool.SchemaAttributes[i].StringAttributeConstraints.MinLength");
            NumberAttributeConstraintsMinValue = jsonResponse.stringOf("UserPool.SchemaAttributes[i].NumberAttributeConstraints.MinValue");
            i = i + 1;
        }
    }
}