com.amazonaws.services.cognitoidp

Class AbstractAWSCognitoIdentityProvider

java.lang.Object

com.amazonaws.services.cognitoidp.AbstractAWSCognitoIdentityProvider

All Implemented Interfaces:

AWSCognitoIdentityProvider

Direct Known Subclasses:

AbstractAWSCognitoIdentityProviderAsync

public class AbstractAWSCognitoIdentityProvider
extends Object
implements AWSCognitoIdentityProvider

Abstract implementation of AWSCognitoIdentityProvider. Convenient method forms pass through to the corresponding overload that takes a request object, which throws an UnsupportedOperationException.

Method Summary

Methods

Modifier and Type	Method and Description
AddCustomAttributesResult	addCustomAttributes(AddCustomAttributesRequest request) Adds additional user attributes to the user pool schema.
AdminConfirmSignUpResult	adminConfirmSignUp(AdminConfirmSignUpRequest request) Confirms user registration as an admin without using a confirmation code.
void	adminDeleteUser(AdminDeleteUserRequest request) Deletes a user as an administrator.
AdminDeleteUserAttributesResult	adminDeleteUserAttributes(AdminDeleteUserAttributesRequest request) Deletes the user attributes in a user pool as an administrator.
AdminDisableUserResult	adminDisableUser(AdminDisableUserRequest request) Disables the specified user as an administrator.
AdminEnableUserResult	adminEnableUser(AdminEnableUserRequest request) Enables the specified user as an administrator.
AdminGetUserResult	adminGetUser(AdminGetUserRequest request) Gets the specified user by user name in a user pool as an administrator.
AdminResetUserPasswordResult	adminResetUserPassword(AdminResetUserPasswordRequest request) Resets the specified user's password in a user pool as an administrator.
AdminSetUserSettingsResult	adminSetUserSettings(AdminSetUserSettingsRequest request) Sets all the user settings for a specified user name.
AdminUpdateUserAttributesResult	adminUpdateUserAttributes(AdminUpdateUserAttributesRequest request) Updates the specified user's attributes, including developer attributes, as an administrator.
ChangePasswordResult	changePassword(ChangePasswordRequest request) Changes the password for a specified user in a user pool.
ConfirmForgotPasswordResult	confirmForgotPassword(ConfirmForgotPasswordRequest request) Allows a user to enter a code provided when they reset their password to update their password.
ConfirmSignUpResult	confirmSignUp(ConfirmSignUpRequest request) Confirms registration of a user and handles the existing alias from a previous user.
CreateUserPoolResult	createUserPool(CreateUserPoolRequest request) Creates a new Amazon Cognito user pool and sets the password policy for the pool.
CreateUserPoolClientResult	createUserPoolClient(CreateUserPoolClientRequest request) Creates the user pool client.
void	deleteUser(DeleteUserRequest request) Allows a user to delete one's self.
DeleteUserAttributesResult	deleteUserAttributes(DeleteUserAttributesRequest request) Deletes the attributes for a user.
void	deleteUserPool(DeleteUserPoolRequest request) Deletes the specified Amazon Cognito user pool.
void	deleteUserPoolClient(DeleteUserPoolClientRequest request) Allows the developer to delete the user pool client.
DescribeUserPoolResult	describeUserPool(DescribeUserPoolRequest request) Returns the configuration information and metadata of the specified user pool.
DescribeUserPoolClientResult	describeUserPoolClient(DescribeUserPoolClientRequest request) Client method for returning the configuration information and metadata of the specified user pool client.
ForgotPasswordResult	forgotPassword(ForgotPasswordRequest request) Retrieves the password for the specified client ID or username.
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected.
GetJWKSResult	getJWKS(GetJWKSRequest request) Gets the JSON Web keys for the specified user pool.
GetOpenIdConfigurationResult	getOpenIdConfiguration(GetOpenIdConfigurationRequest request) Gets the OpenId configuration information for the specified user pool.
GetUserResult	getUser(GetUserRequest request) Gets the user attributes and metadata for a user.
GetUserAttributeVerificationCodeResult	getUserAttributeVerificationCode(GetUserAttributeVerificationCodeRequest request) Gets the user attribute verification code for the specified attribute name.
ListUserPoolClientsResult	listUserPoolClients(ListUserPoolClientsRequest request) Lists the clients that have been created for the specified user pool.
ListUserPoolsResult	listUserPools(ListUserPoolsRequest request) Lists the user pools associated with an AWS account.
ListUsersResult	listUsers(ListUsersRequest request) Lists the users in the Amazon Cognito user pool.
ResendConfirmationCodeResult	resendConfirmationCode(ResendConfirmationCodeRequest request) Resends the confirmation (for confirmation of registration) to a specific user in the user pool.
void	setEndpoint(String endpoint) Overrides the default endpoint for this client ("https://cognito-idp.us-east-1.amazonaws.com").
void	setRegion(Region region) An alternative to AWSCognitoIdentityProvider.setEndpoint(String), sets the regional endpoint for this client's service calls.
SetUserSettingsResult	setUserSettings(SetUserSettingsRequest request) Sets the user settings like multi-factor authentication (MFA).
void	shutdown() Shuts down this client object, releasing any resources that might be held open.
SignUpResult	signUp(SignUpRequest request) Registers the user in the specified user pool and creates a user name, password, and user attributes.
UpdateUserAttributesResult	updateUserAttributes(UpdateUserAttributesRequest request) Allows a user to update a specific attribute (one at a time).
UpdateUserPoolResult	updateUserPool(UpdateUserPoolRequest request) Updates the specified user pool with the specified attributes.
UpdateUserPoolClientResult	updateUserPoolClient(UpdateUserPoolClientRequest request) Allows the developer to update the specified user pool client and password policy.
VerifyUserAttributeResult	verifyUserAttribute(VerifyUserAttributeRequest request) Verifies the specified user attributes in the user pool.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

setEndpoint

public void setEndpoint(String endpoint)

Description copied from interface: AWSCognitoIdentityProvider

Overrides the default endpoint for this client ("https://cognito-idp.us-east-1.amazonaws.com"). Callers can use this method to control which AWS region they want to work with.

Callers can pass in just the endpoint (ex: "cognito-idp.us-east-1.amazonaws.com") or a full URL, including the protocol (ex: "https://cognito-idp.us-east-1.amazonaws.com"). If the protocol is not specified here, the default protocol from this client's ClientConfiguration will be used, which by default is HTTPS.

For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: http://developer.amazonwebservices.com/connect/entry.jspa?externalID= 3912

This method is not threadsafe. An endpoint should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.

Specified by:

setEndpoint in interface AWSCognitoIdentityProvider

Parameters:

endpoint - The endpoint (ex: "cognito-idp.us-east-1.amazonaws.com") or a full URL, including the protocol (ex: "https://cognito-idp.us-east-1.amazonaws.com") of the region specific AWS endpoint this client will communicate with.

setRegion

public void setRegion(Region region)

Description copied from interface: AWSCognitoIdentityProvider

An alternative to AWSCognitoIdentityProvider.setEndpoint(String), sets the regional endpoint for this client's service calls. Callers can use this method to control which AWS region they want to work with.

By default, all service endpoints in all regions use the https protocol. To use http instead, specify it in the ClientConfiguration supplied at construction.

This method is not threadsafe. A region should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.

Specified by:

setRegion in interface AWSCognitoIdentityProvider

Parameters:

region - The region this client will communicate with. See Region.getRegion(com.amazonaws.regions.Regions) for accessing a given region. Must not be null and must be a region where the service is available.

See Also:

Region.getRegion(com.amazonaws.regions.Regions), Region.createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration), Region.isServiceSupported(String)

addCustomAttributes

public AddCustomAttributesResult addCustomAttributes(AddCustomAttributesRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Adds additional user attributes to the user pool schema.

Specified by:

addCustomAttributes in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to add custom attributes.

Returns:

Result of the AddCustomAttributes operation returned by the service.

adminConfirmSignUp

public AdminConfirmSignUpResult adminConfirmSignUp(AdminConfirmSignUpRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Confirms user registration as an admin without using a confirmation code. Works on any user.

Specified by:

adminConfirmSignUp in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to confirm user registration.

Returns:

Result of the AdminConfirmSignUp operation returned by the service.

adminDeleteUser

public void adminDeleteUser(AdminDeleteUserRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Deletes a user as an administrator. Works on any user.

Specified by:

adminDeleteUser in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to delete a user as an administrator.

adminDeleteUserAttributes

public AdminDeleteUserAttributesResult adminDeleteUserAttributes(AdminDeleteUserAttributesRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Deletes the user attributes in a user pool as an administrator. Works on any user.

Specified by:

adminDeleteUserAttributes in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to delete user attributes as an administrator.

Returns:

Result of the AdminDeleteUserAttributes operation returned by the service.

adminDisableUser

public AdminDisableUserResult adminDisableUser(AdminDisableUserRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Disables the specified user as an administrator. Works on any user.

Specified by:

adminDisableUser in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to disable any user as an administrator.

Returns:

Result of the AdminDisableUser operation returned by the service.

adminEnableUser

public AdminEnableUserResult adminEnableUser(AdminEnableUserRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Enables the specified user as an administrator. Works on any user.

Specified by:

adminEnableUser in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request that enables the user as an administrator.

Returns:

Result of the AdminEnableUser operation returned by the service.

adminGetUser

public AdminGetUserResult adminGetUser(AdminGetUserRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Gets the specified user by user name in a user pool as an administrator. Works on any user.

Specified by:

adminGetUser in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to get the specified user as an administrator.

Returns:

Result of the AdminGetUser operation returned by the service.

adminResetUserPassword

public AdminResetUserPasswordResult adminResetUserPassword(AdminResetUserPasswordRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Resets the specified user's password in a user pool as an administrator. Works on any user.

Specified by:

adminResetUserPassword in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to reset a user's password as an administrator.

Returns:

Result of the AdminResetUserPassword operation returned by the service.

adminSetUserSettings

public AdminSetUserSettingsResult adminSetUserSettings(AdminSetUserSettingsRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Sets all the user settings for a specified user name. Works on any user.

Specified by:

adminSetUserSettings in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to set user settings as an administrator.

Returns:

Result of the AdminSetUserSettings operation returned by the service.

adminUpdateUserAttributes

public AdminUpdateUserAttributesResult adminUpdateUserAttributes(AdminUpdateUserAttributesRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Updates the specified user's attributes, including developer attributes, as an administrator. Works on any user.

Specified by:

adminUpdateUserAttributes in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to update the user's attributes as an administrator.

Returns:

Result of the AdminUpdateUserAttributes operation returned by the service.

changePassword

public ChangePasswordResult changePassword(ChangePasswordRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Changes the password for a specified user in a user pool.

Specified by:

changePassword in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to change a user password.

Returns:

Result of the ChangePassword operation returned by the service.

confirmForgotPassword

public ConfirmForgotPasswordResult confirmForgotPassword(ConfirmForgotPasswordRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Allows a user to enter a code provided when they reset their password to update their password.

Specified by:

confirmForgotPassword in interface AWSCognitoIdentityProvider

Parameters:

request - The request representing the confirmation for a password reset.

Returns:

Result of the ConfirmForgotPassword operation returned by the service.

confirmSignUp

public ConfirmSignUpResult confirmSignUp(ConfirmSignUpRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Confirms registration of a user and handles the existing alias from a previous user.

Specified by:

confirmSignUp in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to confirm registration of a user.

Returns:

Result of the ConfirmSignUp operation returned by the service.

createUserPool

public CreateUserPoolResult createUserPool(CreateUserPoolRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Creates a new Amazon Cognito user pool and sets the password policy for the pool.

Specified by:

createUserPool in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to create a user pool.

Returns:

Result of the CreateUserPool operation returned by the service.

createUserPoolClient

public CreateUserPoolClientResult createUserPoolClient(CreateUserPoolClientRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Creates the user pool client.

Specified by:

createUserPoolClient in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to create a user pool client.

Returns:

Result of the CreateUserPoolClient operation returned by the service.

deleteUser

public void deleteUser(DeleteUserRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Allows a user to delete one's self.

Specified by:

deleteUser in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to delete a user.

deleteUserAttributes

public DeleteUserAttributesResult deleteUserAttributes(DeleteUserAttributesRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Deletes the attributes for a user.

Specified by:

deleteUserAttributes in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to delete user attributes.

Returns:

Result of the DeleteUserAttributes operation returned by the service.

deleteUserPool

public void deleteUserPool(DeleteUserPoolRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Deletes the specified Amazon Cognito user pool.

Specified by:

deleteUserPool in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to delete a user pool.

deleteUserPoolClient

public void deleteUserPoolClient(DeleteUserPoolClientRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Allows the developer to delete the user pool client.

Specified by:

deleteUserPoolClient in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to delete a user pool client.

describeUserPool

public DescribeUserPoolResult describeUserPool(DescribeUserPoolRequest request)

Description copied from interface: AWSCognitoIdentityProvider

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

Specified by:

describeUserPool in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to describe the user pool.

Returns:

Result of the DescribeUserPool operation returned by the service.

describeUserPoolClient

public DescribeUserPoolClientResult describeUserPoolClient(DescribeUserPoolClientRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Client method for returning the configuration information and metadata of the specified user pool client.

Specified by:

describeUserPoolClient in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to describe a user pool client.

Returns:

Result of the DescribeUserPoolClient operation returned by the service.

forgotPassword

public ForgotPasswordResult forgotPassword(ForgotPasswordRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Retrieves the password for the specified client ID or username.

Specified by:

forgotPassword in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to reset a user's password.

Returns:

Result of the ForgotPassword operation returned by the service.

getJWKS

public GetJWKSResult getJWKS(GetJWKSRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Gets the JSON Web keys for the specified user pool.

Specified by:

getJWKS in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to get JSON Web keys.

Returns:

Result of the GetJWKS operation returned by the service.

getOpenIdConfiguration

public GetOpenIdConfigurationResult getOpenIdConfiguration(GetOpenIdConfigurationRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Gets the OpenId configuration information for the specified user pool.

Specified by:

getOpenIdConfiguration in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to get the Open ID configuration.

Returns:

Result of the GetOpenIdConfiguration operation returned by the service.

getUser

public GetUserResult getUser(GetUserRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Gets the user attributes and metadata for a user.

Specified by:

getUser in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to get information about the user.

Returns:

Result of the GetUser operation returned by the service.

getUserAttributeVerificationCode

public GetUserAttributeVerificationCodeResult getUserAttributeVerificationCode(GetUserAttributeVerificationCodeRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Gets the user attribute verification code for the specified attribute name.

Specified by:

getUserAttributeVerificationCode in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to get user attribute verification.

Returns:

Result of the GetUserAttributeVerificationCode operation returned by the service.

listUserPoolClients

public ListUserPoolClientsResult listUserPoolClients(ListUserPoolClientsRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Lists the clients that have been created for the specified user pool.

Specified by:

listUserPoolClients in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to list the user pool clients.

Returns:

Result of the ListUserPoolClients operation returned by the service.

listUserPools

public ListUserPoolsResult listUserPools(ListUserPoolsRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Lists the user pools associated with an AWS account.

Specified by:

listUserPools in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to list user pools.

Returns:

Result of the ListUserPools operation returned by the service.

listUsers

public ListUsersResult listUsers(ListUsersRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Lists the users in the Amazon Cognito user pool.

Specified by:

listUsers in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to list users.

Returns:

Result of the ListUsers operation returned by the service.

resendConfirmationCode

public ResendConfirmationCodeResult resendConfirmationCode(ResendConfirmationCodeRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Resends the confirmation (for confirmation of registration) to a specific user in the user pool.

Specified by:

resendConfirmationCode in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to resend the confirmation code.

Returns:

Result of the ResendConfirmationCode operation returned by the service.

setUserSettings

public SetUserSettingsResult setUserSettings(SetUserSettingsRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Sets the user settings like multi-factor authentication (MFA). If MFA is to be removed for a particular attribute pass the attribute with code delivery as null. If null list is passed, all MFA options are removed.

Specified by:

setUserSettings in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to set user settings.

Returns:

Result of the SetUserSettings operation returned by the service.

signUp

public SignUpResult signUp(SignUpRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Registers the user in the specified user pool and creates a user name, password, and user attributes.

Specified by:

signUp in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to register a user.

Returns:

Result of the SignUp operation returned by the service.

updateUserAttributes

public UpdateUserAttributesResult updateUserAttributes(UpdateUserAttributesRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Allows a user to update a specific attribute (one at a time).

Specified by:

updateUserAttributes in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to update user attributes.

Returns:

Result of the UpdateUserAttributes operation returned by the service.

updateUserPool

public UpdateUserPoolResult updateUserPool(UpdateUserPoolRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Updates the specified user pool with the specified attributes.

Specified by:

updateUserPool in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to update the user pool.

Returns:

Result of the UpdateUserPool operation returned by the service.

updateUserPoolClient

public UpdateUserPoolClientResult updateUserPoolClient(UpdateUserPoolClientRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Allows the developer to update the specified user pool client and password policy.

Specified by:

updateUserPoolClient in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to update the user pool client.

Returns:

Result of the UpdateUserPoolClient operation returned by the service.

verifyUserAttribute

public VerifyUserAttributeResult verifyUserAttribute(VerifyUserAttributeRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Verifies the specified user attributes in the user pool.

Specified by:

verifyUserAttribute in interface AWSCognitoIdentityProvider

Parameters:

request - Represents the request to verify user attributes.

Returns:

Result of the VerifyUserAttribute operation returned by the service.

shutdown

public void shutdown()

Description copied from interface: AWSCognitoIdentityProvider

Shuts down this client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it should not be used to make any more requests.

Specified by:

shutdown in interface AWSCognitoIdentityProvider

getCachedResponseMetadata

public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

Description copied from interface: AWSCognitoIdentityProvider

Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.

Specified by:

getCachedResponseMetadata in interface AWSCognitoIdentityProvider

Parameters:

request - The originally executed request.

Returns:

The response metadata for the specified request, or null if none is available.