Interface UserPoolType.Builder
- All Superinterfaces:
Buildable
,CopyableBuilder<UserPoolType.Builder,
,UserPoolType> SdkBuilder<UserPoolType.Builder,
,UserPoolType> SdkPojo
- Enclosing class:
UserPoolType
-
Method Summary
Modifier and TypeMethodDescriptiondefault UserPoolType.Builder
accountRecoverySetting
(Consumer<AccountRecoverySettingType.Builder> accountRecoverySetting) The available verified method a user can use to recover their password when they callForgotPassword
.accountRecoverySetting
(AccountRecoverySettingType accountRecoverySetting) The available verified method a user can use to recover their password when they callForgotPassword
.default UserPoolType.Builder
adminCreateUserConfig
(Consumer<AdminCreateUserConfigType.Builder> adminCreateUserConfig) The configuration forAdminCreateUser
requests.adminCreateUserConfig
(AdminCreateUserConfigType adminCreateUserConfig) The configuration forAdminCreateUser
requests.aliasAttributes
(Collection<AliasAttributeType> aliasAttributes) The attributes that are aliased in a user pool.aliasAttributes
(AliasAttributeType... aliasAttributes) The attributes that are aliased in a user pool.aliasAttributesWithStrings
(String... aliasAttributes) The attributes that are aliased in a user pool.aliasAttributesWithStrings
(Collection<String> aliasAttributes) The attributes that are aliased in a user pool.The Amazon Resource Name (ARN) for the user pool.autoVerifiedAttributes
(Collection<VerifiedAttributeType> autoVerifiedAttributes) The attributes that are auto-verified in a user pool.autoVerifiedAttributes
(VerifiedAttributeType... autoVerifiedAttributes) The attributes that are auto-verified in a user pool.autoVerifiedAttributesWithStrings
(String... autoVerifiedAttributes) The attributes that are auto-verified in a user pool.autoVerifiedAttributesWithStrings
(Collection<String> autoVerifiedAttributes) The attributes that are auto-verified in a user pool.creationDate
(Instant creationDate) The date and time, in ISO 8601 format, when the item was created.customDomain
(String customDomain) A custom domain name that you provide to Amazon Cognito.deletionProtection
(String deletionProtection) When active,DeletionProtection
prevents accidental deletion of your user pool.deletionProtection
(DeletionProtectionType deletionProtection) When active,DeletionProtection
prevents accidental deletion of your user pool.default UserPoolType.Builder
deviceConfiguration
(Consumer<DeviceConfigurationType.Builder> deviceConfiguration) The device-remembering configuration for a user pool.deviceConfiguration
(DeviceConfigurationType deviceConfiguration) The device-remembering configuration for a user pool.The domain prefix, if the user pool has a domain associated with it.default UserPoolType.Builder
emailConfiguration
(Consumer<EmailConfigurationType.Builder> emailConfiguration) The email configuration of your user pool.emailConfiguration
(EmailConfigurationType emailConfiguration) The email configuration of your user pool.emailConfigurationFailure
(String emailConfigurationFailure) Deprecated.emailVerificationMessage
(String emailVerificationMessage) This parameter is no longer used.emailVerificationSubject
(String emailVerificationSubject) This parameter is no longer used.estimatedNumberOfUsers
(Integer estimatedNumberOfUsers) A number estimating the size of the user pool.The ID of the user pool.default UserPoolType.Builder
lambdaConfig
(Consumer<LambdaConfigType.Builder> lambdaConfig) The Lambda triggers associated with the user pool.lambdaConfig
(LambdaConfigType lambdaConfig) The Lambda triggers associated with the user pool.lastModifiedDate
(Instant lastModifiedDate) The date and time, in ISO 8601 format, when the item was modified.mfaConfiguration
(String mfaConfiguration) Can be one of the following values:mfaConfiguration
(UserPoolMfaType mfaConfiguration) Can be one of the following values:The name of the user pool.default UserPoolType.Builder
policies
(Consumer<UserPoolPolicyType.Builder> policies) The policies associated with the user pool.policies
(UserPoolPolicyType policies) The policies associated with the user pool.schemaAttributes
(Collection<SchemaAttributeType> schemaAttributes) A list of the user attributes and their properties in your user pool.schemaAttributes
(Consumer<SchemaAttributeType.Builder>... schemaAttributes) A list of the user attributes and their properties in your user pool.schemaAttributes
(SchemaAttributeType... schemaAttributes) A list of the user attributes and their properties in your user pool.smsAuthenticationMessage
(String smsAuthenticationMessage) The contents of the SMS authentication message.default UserPoolType.Builder
smsConfiguration
(Consumer<SmsConfigurationType.Builder> smsConfiguration) The SMS configuration with the settings that your Amazon Cognito user pool must use to send an SMS message from your Amazon Web Services account through Amazon Simple Notification Service.smsConfiguration
(SmsConfigurationType smsConfiguration) The SMS configuration with the settings that your Amazon Cognito user pool must use to send an SMS message from your Amazon Web Services account through Amazon Simple Notification Service.smsConfigurationFailure
(String smsConfigurationFailure) The reason why the SMS configuration can't send the messages to your users.smsVerificationMessage
(String smsVerificationMessage) This parameter is no longer used.Deprecated.This property is no longer available.status
(StatusType status) Deprecated.This property is no longer available.default UserPoolType.Builder
userAttributeUpdateSettings
(Consumer<UserAttributeUpdateSettingsType.Builder> userAttributeUpdateSettings) The settings for updates to user attributes.userAttributeUpdateSettings
(UserAttributeUpdateSettingsType userAttributeUpdateSettings) The settings for updates to user attributes.usernameAttributes
(Collection<UsernameAttributeType> usernameAttributes) Specifies whether a user can use an email address or phone number as a username when they sign up.usernameAttributes
(UsernameAttributeType... usernameAttributes) Specifies whether a user can use an email address or phone number as a username when they sign up.usernameAttributesWithStrings
(String... usernameAttributes) Specifies whether a user can use an email address or phone number as a username when they sign up.usernameAttributesWithStrings
(Collection<String> usernameAttributes) Specifies whether a user can use an email address or phone number as a username when they sign up.default UserPoolType.Builder
usernameConfiguration
(Consumer<UsernameConfigurationType.Builder> usernameConfiguration) Case sensitivity of the username input for the selected sign-in option.usernameConfiguration
(UsernameConfigurationType usernameConfiguration) Case sensitivity of the username input for the selected sign-in option.default UserPoolType.Builder
userPoolAddOns
(Consumer<UserPoolAddOnsType.Builder> userPoolAddOns) User pool add-ons.userPoolAddOns
(UserPoolAddOnsType userPoolAddOns) User pool add-ons.userPoolTags
(Map<String, String> userPoolTags) The tags that are assigned to the user pool.default UserPoolType.Builder
verificationMessageTemplate
(Consumer<VerificationMessageTemplateType.Builder> verificationMessageTemplate) The template for verification messages.verificationMessageTemplate
(VerificationMessageTemplateType verificationMessageTemplate) The template for verification messages.Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
Method Details
-
id
The ID of the user pool.
- Parameters:
id
- The ID of the user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
name
The name of the user pool.
- Parameters:
name
- The name of the user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
policies
The policies associated with the user pool.
- Parameters:
policies
- The policies associated with the user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
policies
The policies associated with the user pool.
This is a convenience method that creates an instance of theUserPoolPolicyType.Builder
avoiding the need to create one manually viaUserPoolPolicyType.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed topolicies(UserPoolPolicyType)
.- Parameters:
policies
- a consumer that will call methods onUserPoolPolicyType.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
deletionProtection
When active,
DeletionProtection
prevents accidental deletion of your user pool. Before you can delete a user pool that you have protected against deletion, you must deactivate this feature.When you try to delete a protected user pool in a
DeleteUserPool
API request, Amazon Cognito returns anInvalidParameterException
error. To delete a protected user pool, send a newDeleteUserPool
request after you deactivate deletion protection in anUpdateUserPool
API request.- Parameters:
deletionProtection
- When active,DeletionProtection
prevents accidental deletion of your user pool. Before you can delete a user pool that you have protected against deletion, you must deactivate this feature.When you try to delete a protected user pool in a
DeleteUserPool
API request, Amazon Cognito returns anInvalidParameterException
error. To delete a protected user pool, send a newDeleteUserPool
request after you deactivate deletion protection in anUpdateUserPool
API request.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
deletionProtection
When active,
DeletionProtection
prevents accidental deletion of your user pool. Before you can delete a user pool that you have protected against deletion, you must deactivate this feature.When you try to delete a protected user pool in a
DeleteUserPool
API request, Amazon Cognito returns anInvalidParameterException
error. To delete a protected user pool, send a newDeleteUserPool
request after you deactivate deletion protection in anUpdateUserPool
API request.- Parameters:
deletionProtection
- When active,DeletionProtection
prevents accidental deletion of your user pool. Before you can delete a user pool that you have protected against deletion, you must deactivate this feature.When you try to delete a protected user pool in a
DeleteUserPool
API request, Amazon Cognito returns anInvalidParameterException
error. To delete a protected user pool, send a newDeleteUserPool
request after you deactivate deletion protection in anUpdateUserPool
API request.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
lambdaConfig
The Lambda triggers associated with the user pool.
- Parameters:
lambdaConfig
- The Lambda triggers associated with the user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
lambdaConfig
The Lambda triggers associated with the user pool.
This is a convenience method that creates an instance of theLambdaConfigType.Builder
avoiding the need to create one manually viaLambdaConfigType.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tolambdaConfig(LambdaConfigType)
.- Parameters:
lambdaConfig
- a consumer that will call methods onLambdaConfigType.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
status
Deprecated.This property is no longer available.This parameter is no longer used.
- Parameters:
status
- This parameter is no longer used.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
status
Deprecated.This property is no longer available.This parameter is no longer used.
- Parameters:
status
- This parameter is no longer used.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
lastModifiedDate
The date and time, in ISO 8601 format, when the item was modified.
- Parameters:
lastModifiedDate
- The date and time, in ISO 8601 format, when the item was modified.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
creationDate
The date and time, in ISO 8601 format, when the item was created.
- Parameters:
creationDate
- The date and time, in ISO 8601 format, when the item was created.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
schemaAttributes
A list of the user attributes and their properties in your user pool. The attribute schema contains standard attributes, custom attributes with a
custom:
prefix, and developer attributes with adev:
prefix. For more information, see User pool attributes.Developer-only attributes are a legacy feature of user pools, are read-only to all app clients. You can create and update developer-only attributes only with IAM-authenticated API operations. Use app client read/write permissions instead.
- Parameters:
schemaAttributes
- A list of the user attributes and their properties in your user pool. The attribute schema contains standard attributes, custom attributes with acustom:
prefix, and developer attributes with adev:
prefix. For more information, see User pool attributes.Developer-only attributes are a legacy feature of user pools, are read-only to all app clients. You can create and update developer-only attributes only with IAM-authenticated API operations. Use app client read/write permissions instead.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
schemaAttributes
A list of the user attributes and their properties in your user pool. The attribute schema contains standard attributes, custom attributes with a
custom:
prefix, and developer attributes with adev:
prefix. For more information, see User pool attributes.Developer-only attributes are a legacy feature of user pools, are read-only to all app clients. You can create and update developer-only attributes only with IAM-authenticated API operations. Use app client read/write permissions instead.
- Parameters:
schemaAttributes
- A list of the user attributes and their properties in your user pool. The attribute schema contains standard attributes, custom attributes with acustom:
prefix, and developer attributes with adev:
prefix. For more information, see User pool attributes.Developer-only attributes are a legacy feature of user pools, are read-only to all app clients. You can create and update developer-only attributes only with IAM-authenticated API operations. Use app client read/write permissions instead.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
schemaAttributes
A list of the user attributes and their properties in your user pool. The attribute schema contains standard attributes, custom attributes with a
custom:
prefix, and developer attributes with adev:
prefix. For more information, see User pool attributes.Developer-only attributes are a legacy feature of user pools, are read-only to all app clients. You can create and update developer-only attributes only with IAM-authenticated API operations. Use app client read/write permissions instead.
This is a convenience method that creates an instance of theSchemaAttributeType.Builder
avoiding the need to create one manually viaSchemaAttributeType.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toschemaAttributes(List<SchemaAttributeType>)
.- Parameters:
schemaAttributes
- a consumer that will call methods onSchemaAttributeType.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
autoVerifiedAttributesWithStrings
The attributes that are auto-verified in a user pool.
- Parameters:
autoVerifiedAttributes
- The attributes that are auto-verified in a user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
autoVerifiedAttributesWithStrings
The attributes that are auto-verified in a user pool.
- Parameters:
autoVerifiedAttributes
- The attributes that are auto-verified in a user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
autoVerifiedAttributes
UserPoolType.Builder autoVerifiedAttributes(Collection<VerifiedAttributeType> autoVerifiedAttributes) The attributes that are auto-verified in a user pool.
- Parameters:
autoVerifiedAttributes
- The attributes that are auto-verified in a user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
autoVerifiedAttributes
The attributes that are auto-verified in a user pool.
- Parameters:
autoVerifiedAttributes
- The attributes that are auto-verified in a user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
aliasAttributesWithStrings
The attributes that are aliased in a user pool.
- Parameters:
aliasAttributes
- The attributes that are aliased in a user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
aliasAttributesWithStrings
The attributes that are aliased in a user pool.
- Parameters:
aliasAttributes
- The attributes that are aliased in a user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
aliasAttributes
The attributes that are aliased in a user pool.
- Parameters:
aliasAttributes
- The attributes that are aliased in a user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
aliasAttributes
The attributes that are aliased in a user pool.
- Parameters:
aliasAttributes
- The attributes that are aliased in a user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
usernameAttributesWithStrings
Specifies whether a user can use an email address or phone number as a username when they sign up.
- Parameters:
usernameAttributes
- Specifies whether a user can use an email address or phone number as a username when they sign up.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
usernameAttributesWithStrings
Specifies whether a user can use an email address or phone number as a username when they sign up.
- Parameters:
usernameAttributes
- Specifies whether a user can use an email address or phone number as a username when they sign up.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
usernameAttributes
Specifies whether a user can use an email address or phone number as a username when they sign up.
- Parameters:
usernameAttributes
- Specifies whether a user can use an email address or phone number as a username when they sign up.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
usernameAttributes
Specifies whether a user can use an email address or phone number as a username when they sign up.
- Parameters:
usernameAttributes
- Specifies whether a user can use an email address or phone number as a username when they sign up.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
smsVerificationMessage
This parameter is no longer used. See VerificationMessageTemplateType.
- Parameters:
smsVerificationMessage
- This parameter is no longer used. See VerificationMessageTemplateType.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
emailVerificationMessage
This parameter is no longer used. See VerificationMessageTemplateType.
- Parameters:
emailVerificationMessage
- This parameter is no longer used. See VerificationMessageTemplateType.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
emailVerificationSubject
This parameter is no longer used. See VerificationMessageTemplateType.
- Parameters:
emailVerificationSubject
- This parameter is no longer used. See VerificationMessageTemplateType.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
verificationMessageTemplate
UserPoolType.Builder verificationMessageTemplate(VerificationMessageTemplateType verificationMessageTemplate) The template for verification messages.
- Parameters:
verificationMessageTemplate
- The template for verification messages.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
verificationMessageTemplate
default UserPoolType.Builder verificationMessageTemplate(Consumer<VerificationMessageTemplateType.Builder> verificationMessageTemplate) The template for verification messages.
This is a convenience method that creates an instance of theVerificationMessageTemplateType.Builder
avoiding the need to create one manually viaVerificationMessageTemplateType.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toverificationMessageTemplate(VerificationMessageTemplateType)
.- Parameters:
verificationMessageTemplate
- a consumer that will call methods onVerificationMessageTemplateType.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
smsAuthenticationMessage
The contents of the SMS authentication message.
- Parameters:
smsAuthenticationMessage
- The contents of the SMS authentication message.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
userAttributeUpdateSettings
UserPoolType.Builder userAttributeUpdateSettings(UserAttributeUpdateSettingsType userAttributeUpdateSettings) The settings for updates to user attributes. These settings include the property
AttributesRequireVerificationBeforeUpdate
, a user-pool setting that tells Amazon Cognito how to handle changes to the value of your users' email address and phone number attributes. For more information, see Verifying updates to email addresses and phone numbers.- Parameters:
userAttributeUpdateSettings
- The settings for updates to user attributes. These settings include the propertyAttributesRequireVerificationBeforeUpdate
, a user-pool setting that tells Amazon Cognito how to handle changes to the value of your users' email address and phone number attributes. For more information, see Verifying updates to email addresses and phone numbers.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
userAttributeUpdateSettings
default UserPoolType.Builder userAttributeUpdateSettings(Consumer<UserAttributeUpdateSettingsType.Builder> userAttributeUpdateSettings) The settings for updates to user attributes. These settings include the property
This is a convenience method that creates an instance of theAttributesRequireVerificationBeforeUpdate
, a user-pool setting that tells Amazon Cognito how to handle changes to the value of your users' email address and phone number attributes. For more information, see Verifying updates to email addresses and phone numbers.UserAttributeUpdateSettingsType.Builder
avoiding the need to create one manually viaUserAttributeUpdateSettingsType.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed touserAttributeUpdateSettings(UserAttributeUpdateSettingsType)
.- Parameters:
userAttributeUpdateSettings
- a consumer that will call methods onUserAttributeUpdateSettingsType.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
mfaConfiguration
Can be one of the following values:
-
OFF
- MFA tokens aren't required and can't be specified during user registration. -
ON
- MFA tokens are required for all user registrations. You can only specify required when you're initially creating a user pool. -
OPTIONAL
- Users have the option when registering to create an MFA token.
- Parameters:
mfaConfiguration
- Can be one of the following values:-
OFF
- MFA tokens aren't required and can't be specified during user registration. -
ON
- MFA tokens are required for all user registrations. You can only specify required when you're initially creating a user pool. -
OPTIONAL
- Users have the option when registering to create an MFA token.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
mfaConfiguration
Can be one of the following values:
-
OFF
- MFA tokens aren't required and can't be specified during user registration. -
ON
- MFA tokens are required for all user registrations. You can only specify required when you're initially creating a user pool. -
OPTIONAL
- Users have the option when registering to create an MFA token.
- Parameters:
mfaConfiguration
- Can be one of the following values:-
OFF
- MFA tokens aren't required and can't be specified during user registration. -
ON
- MFA tokens are required for all user registrations. You can only specify required when you're initially creating a user pool. -
OPTIONAL
- Users have the option when registering to create an MFA token.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
deviceConfiguration
The device-remembering configuration for a user pool. A null value indicates that you have deactivated device remembering in your user pool.
When you provide a value for any
DeviceConfiguration
field, you activate the Amazon Cognito device-remembering feature.- Parameters:
deviceConfiguration
- The device-remembering configuration for a user pool. A null value indicates that you have deactivated device remembering in your user pool.When you provide a value for any
DeviceConfiguration
field, you activate the Amazon Cognito device-remembering feature.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
deviceConfiguration
default UserPoolType.Builder deviceConfiguration(Consumer<DeviceConfigurationType.Builder> deviceConfiguration) The device-remembering configuration for a user pool. A null value indicates that you have deactivated device remembering in your user pool.
When you provide a value for any
DeviceConfiguration
field, you activate the Amazon Cognito device-remembering feature.DeviceConfigurationType.Builder
avoiding the need to create one manually viaDeviceConfigurationType.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed todeviceConfiguration(DeviceConfigurationType)
.- Parameters:
deviceConfiguration
- a consumer that will call methods onDeviceConfigurationType.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
estimatedNumberOfUsers
A number estimating the size of the user pool.
- Parameters:
estimatedNumberOfUsers
- A number estimating the size of the user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
emailConfiguration
The email configuration of your user pool. The email configuration type sets your preferred sending method, Amazon Web Services Region, and sender for messages from your user pool.
- Parameters:
emailConfiguration
- The email configuration of your user pool. The email configuration type sets your preferred sending method, Amazon Web Services Region, and sender for messages from your user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
emailConfiguration
default UserPoolType.Builder emailConfiguration(Consumer<EmailConfigurationType.Builder> emailConfiguration) The email configuration of your user pool. The email configuration type sets your preferred sending method, Amazon Web Services Region, and sender for messages from your user pool.
This is a convenience method that creates an instance of theEmailConfigurationType.Builder
avoiding the need to create one manually viaEmailConfigurationType.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toemailConfiguration(EmailConfigurationType)
.- Parameters:
emailConfiguration
- a consumer that will call methods onEmailConfigurationType.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
smsConfiguration
The SMS configuration with the settings that your Amazon Cognito user pool must use to send an SMS message from your Amazon Web Services account through Amazon Simple Notification Service. To send SMS messages with Amazon SNS in the Amazon Web Services Region that you want, the Amazon Cognito user pool uses an Identity and Access Management (IAM) role in your Amazon Web Services account.
- Parameters:
smsConfiguration
- The SMS configuration with the settings that your Amazon Cognito user pool must use to send an SMS message from your Amazon Web Services account through Amazon Simple Notification Service. To send SMS messages with Amazon SNS in the Amazon Web Services Region that you want, the Amazon Cognito user pool uses an Identity and Access Management (IAM) role in your Amazon Web Services account.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
smsConfiguration
default UserPoolType.Builder smsConfiguration(Consumer<SmsConfigurationType.Builder> smsConfiguration) The SMS configuration with the settings that your Amazon Cognito user pool must use to send an SMS message from your Amazon Web Services account through Amazon Simple Notification Service. To send SMS messages with Amazon SNS in the Amazon Web Services Region that you want, the Amazon Cognito user pool uses an Identity and Access Management (IAM) role in your Amazon Web Services account.
This is a convenience method that creates an instance of theSmsConfigurationType.Builder
avoiding the need to create one manually viaSmsConfigurationType.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tosmsConfiguration(SmsConfigurationType)
.- Parameters:
smsConfiguration
- a consumer that will call methods onSmsConfigurationType.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
userPoolTags
The tags that are assigned to the user pool. A tag is a label that you can apply to user pools to categorize and manage them in different ways, such as by purpose, owner, environment, or other criteria.
- Parameters:
userPoolTags
- The tags that are assigned to the user pool. A tag is a label that you can apply to user pools to categorize and manage them in different ways, such as by purpose, owner, environment, or other criteria.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
smsConfigurationFailure
The reason why the SMS configuration can't send the messages to your users.
This message might include comma-separated values to describe why your SMS configuration can't send messages to user pool end users.
- InvalidSmsRoleAccessPolicyException
-
The Identity and Access Management role that Amazon Cognito uses to send SMS messages isn't properly configured. For more information, see SmsConfigurationType.
- SNSSandbox
-
The Amazon Web Services account is in the SNS SMS Sandbox and messages will only reach verified end users. This parameter won’t get populated with SNSSandbox if the user creating the user pool doesn’t have SNS permissions. To learn how to move your Amazon Web Services account out of the sandbox, see Moving out of the SMS sandbox.
- Parameters:
smsConfigurationFailure
- The reason why the SMS configuration can't send the messages to your users.This message might include comma-separated values to describe why your SMS configuration can't send messages to user pool end users.
- InvalidSmsRoleAccessPolicyException
-
The Identity and Access Management role that Amazon Cognito uses to send SMS messages isn't properly configured. For more information, see SmsConfigurationType.
- SNSSandbox
-
The Amazon Web Services account is in the SNS SMS Sandbox and messages will only reach verified end users. This parameter won’t get populated with SNSSandbox if the user creating the user pool doesn’t have SNS permissions. To learn how to move your Amazon Web Services account out of the sandbox, see Moving out of the SMS sandbox.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
emailConfigurationFailure
Deprecated. Review error codes from API requests with
EventSource:cognito-idp.amazonaws.com
in CloudTrail for information about problems with user pool email configuration.- Parameters:
emailConfigurationFailure
- Deprecated. Review error codes from API requests withEventSource:cognito-idp.amazonaws.com
in CloudTrail for information about problems with user pool email configuration.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
domain
The domain prefix, if the user pool has a domain associated with it.
- Parameters:
domain
- The domain prefix, if the user pool has a domain associated with it.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
customDomain
A custom domain name that you provide to Amazon Cognito. This parameter applies only if you use a custom domain to host the sign-up and sign-in pages for your application. An example of a custom domain name might be
auth.example.com
.For more information about adding a custom domain to your user pool, see Using Your Own Domain for the Hosted UI.
- Parameters:
customDomain
- A custom domain name that you provide to Amazon Cognito. This parameter applies only if you use a custom domain to host the sign-up and sign-in pages for your application. An example of a custom domain name might beauth.example.com
.For more information about adding a custom domain to your user pool, see Using Your Own Domain for the Hosted UI.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
adminCreateUserConfig
The configuration for
AdminCreateUser
requests.- Parameters:
adminCreateUserConfig
- The configuration forAdminCreateUser
requests.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
adminCreateUserConfig
default UserPoolType.Builder adminCreateUserConfig(Consumer<AdminCreateUserConfigType.Builder> adminCreateUserConfig) The configuration for
This is a convenience method that creates an instance of theAdminCreateUser
requests.AdminCreateUserConfigType.Builder
avoiding the need to create one manually viaAdminCreateUserConfigType.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toadminCreateUserConfig(AdminCreateUserConfigType)
.- Parameters:
adminCreateUserConfig
- a consumer that will call methods onAdminCreateUserConfigType.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
userPoolAddOns
User pool add-ons. Contains settings for activation of advanced security features. To log user security information but take no action, set to
AUDIT
. To configure automatic security responses to risky traffic to your user pool, set toENFORCED
.For more information, see Adding advanced security to a user pool.
- Parameters:
userPoolAddOns
- User pool add-ons. Contains settings for activation of advanced security features. To log user security information but take no action, set toAUDIT
. To configure automatic security responses to risky traffic to your user pool, set toENFORCED
.For more information, see Adding advanced security to a user pool.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
userPoolAddOns
User pool add-ons. Contains settings for activation of advanced security features. To log user security information but take no action, set to
AUDIT
. To configure automatic security responses to risky traffic to your user pool, set toENFORCED
.For more information, see Adding advanced security to a user pool.
This is a convenience method that creates an instance of theUserPoolAddOnsType.Builder
avoiding the need to create one manually viaUserPoolAddOnsType.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed touserPoolAddOns(UserPoolAddOnsType)
.- Parameters:
userPoolAddOns
- a consumer that will call methods onUserPoolAddOnsType.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
usernameConfiguration
Case sensitivity of the username input for the selected sign-in option. For example, when case sensitivity is set to
False
, users can sign in using either "username" or "Username". This configuration is immutable once it has been set. For more information, see UsernameConfigurationType.- Parameters:
usernameConfiguration
- Case sensitivity of the username input for the selected sign-in option. For example, when case sensitivity is set toFalse
, users can sign in using either "username" or "Username". This configuration is immutable once it has been set. For more information, see UsernameConfigurationType.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
usernameConfiguration
default UserPoolType.Builder usernameConfiguration(Consumer<UsernameConfigurationType.Builder> usernameConfiguration) Case sensitivity of the username input for the selected sign-in option. For example, when case sensitivity is set to
This is a convenience method that creates an instance of theFalse
, users can sign in using either "username" or "Username". This configuration is immutable once it has been set. For more information, see UsernameConfigurationType.UsernameConfigurationType.Builder
avoiding the need to create one manually viaUsernameConfigurationType.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tousernameConfiguration(UsernameConfigurationType)
.- Parameters:
usernameConfiguration
- a consumer that will call methods onUsernameConfigurationType.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
arn
The Amazon Resource Name (ARN) for the user pool.
- Parameters:
arn
- The Amazon Resource Name (ARN) for the user pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
accountRecoverySetting
The available verified method a user can use to recover their password when they call
ForgotPassword
. You can use this setting to define a preferred method when a user has more than one method available. With this setting, SMS doesn't qualify for a valid password recovery mechanism if the user also has SMS multi-factor authentication (MFA) activated. In the absence of this setting, Amazon Cognito uses the legacy behavior to determine the recovery method where SMS is preferred through email.- Parameters:
accountRecoverySetting
- The available verified method a user can use to recover their password when they callForgotPassword
. You can use this setting to define a preferred method when a user has more than one method available. With this setting, SMS doesn't qualify for a valid password recovery mechanism if the user also has SMS multi-factor authentication (MFA) activated. In the absence of this setting, Amazon Cognito uses the legacy behavior to determine the recovery method where SMS is preferred through email.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
accountRecoverySetting
default UserPoolType.Builder accountRecoverySetting(Consumer<AccountRecoverySettingType.Builder> accountRecoverySetting) The available verified method a user can use to recover their password when they call
This is a convenience method that creates an instance of theForgotPassword
. You can use this setting to define a preferred method when a user has more than one method available. With this setting, SMS doesn't qualify for a valid password recovery mechanism if the user also has SMS multi-factor authentication (MFA) activated. In the absence of this setting, Amazon Cognito uses the legacy behavior to determine the recovery method where SMS is preferred through email.AccountRecoverySettingType.Builder
avoiding the need to create one manually viaAccountRecoverySettingType.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toaccountRecoverySetting(AccountRecoverySettingType)
.- Parameters:
accountRecoverySetting
- a consumer that will call methods onAccountRecoverySettingType.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-