com.amazonaws.services.cognitoidentity

Interface AmazonCognitoIdentity

All Known Subinterfaces:

AmazonCognitoIdentityAsync

All Known Implementing Classes:

AmazonCognitoIdentityAsyncClient, AmazonCognitoIdentityClient

public interface AmazonCognitoIdentity

Interface for accessing AmazonCognitoIdentity.

Method Summary

Methods

Modifier and Type	Method and Description
CreateIdentityPoolResult	createIdentityPool(CreateIdentityPoolRequest createIdentityPoolRequest)
void	deleteIdentityPool(DeleteIdentityPoolRequest deleteIdentityPoolRequest)
DescribeIdentityResult	describeIdentity(DescribeIdentityRequest describeIdentityRequest)
DescribeIdentityPoolResult	describeIdentityPool(DescribeIdentityPoolRequest describeIdentityPoolRequest)
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.
GetCredentialsForIdentityResult	getCredentialsForIdentity(GetCredentialsForIdentityRequest getCredentialsForIdentityRequest)
GetIdResult	getId(GetIdRequest getIdRequest)
GetIdentityPoolRolesResult	getIdentityPoolRoles(GetIdentityPoolRolesRequest getIdentityPoolRolesRequest)
GetOpenIdTokenResult	getOpenIdToken(GetOpenIdTokenRequest getOpenIdTokenRequest)
GetOpenIdTokenForDeveloperIdentityResult	getOpenIdTokenForDeveloperIdentity(GetOpenIdTokenForDeveloperIdentityRequest getOpenIdTokenForDeveloperIdentityRequest)
ListIdentitiesResult	listIdentities(ListIdentitiesRequest listIdentitiesRequest)
ListIdentityPoolsResult	listIdentityPools(ListIdentityPoolsRequest listIdentityPoolsRequest)
LookupDeveloperIdentityResult	lookupDeveloperIdentity(LookupDeveloperIdentityRequest lookupDeveloperIdentityRequest)
MergeDeveloperIdentitiesResult	mergeDeveloperIdentities(MergeDeveloperIdentitiesRequest mergeDeveloperIdentitiesRequest)
void	setEndpoint(java.lang.String endpoint) Overrides the default endpoint for this client ("https://cognito-identity.us-east-1.amazonaws.com").
void	setIdentityPoolRoles(SetIdentityPoolRolesRequest setIdentityPoolRolesRequest)
void	setRegion(Region region) An alternative to setEndpoint(String), sets the regional endpoint for this client's service calls.
void	shutdown() Shuts down this client object, releasing any resources that might be held open.
void	unlinkDeveloperIdentity(UnlinkDeveloperIdentityRequest unlinkDeveloperIdentityRequest)
void	unlinkIdentity(UnlinkIdentityRequest unlinkIdentityRequest)
UpdateIdentityPoolResult	updateIdentityPool(UpdateIdentityPoolRequest updateIdentityPoolRequest)

Method Detail

setEndpoint

void setEndpoint(java.lang.String endpoint)
                 throws java.lang.IllegalArgumentException

Overrides the default endpoint for this client ("https://cognito-identity.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-identity.us-east-1.amazonaws.com") or a full URL, including the protocol (ex: "https://cognito-identity.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.

Parameters:

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

Throws:

java.lang.IllegalArgumentException - If any problems are detected with the specified endpoint.

setRegion

void setRegion(Region region)
               throws java.lang.IllegalArgumentException

An alternative to 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.

Parameters:

region - The region this client will communicate with. See Region.getRegion(com.amazonaws.regions.Regions) for accessing a given region.

Throws:

java.lang.IllegalArgumentException - If the given region is null, or if this service isn't available in the given region. See Region.isServiceSupported(String)

See Also:

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

unlinkDeveloperIdentity

void unlinkDeveloperIdentity(UnlinkDeveloperIdentityRequest unlinkDeveloperIdentityRequest)
                             throws AmazonServiceException,
                                    AmazonClientException

Parameters:

unlinkDeveloperIdentityRequest - Container for the necessary parameters to execute the UnlinkDeveloperIdentity service method on AmazonCognitoIdentity.

Throws:

ResourceConflictException

InternalErrorException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

describeIdentityPool

DescribeIdentityPoolResult describeIdentityPool(DescribeIdentityPoolRequest describeIdentityPoolRequest)
                                                throws AmazonServiceException,
                                                       AmazonClientException

Parameters:

describeIdentityPoolRequest - Container for the necessary parameters to execute the DescribeIdentityPool service method on AmazonCognitoIdentity.

Returns:

The response from the DescribeIdentityPool service method, as returned by AmazonCognitoIdentity.

Throws:

InternalErrorException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

getId

GetIdResult getId(GetIdRequest getIdRequest)
                  throws AmazonServiceException,
                         AmazonClientException

Parameters:

getIdRequest - Container for the necessary parameters to execute the GetId service method on AmazonCognitoIdentity.

Returns:

The response from the GetId service method, as returned by AmazonCognitoIdentity.

Throws:

ResourceConflictException

InternalErrorException

LimitExceededException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

deleteIdentityPool

void deleteIdentityPool(DeleteIdentityPoolRequest deleteIdentityPoolRequest)
                        throws AmazonServiceException,
                               AmazonClientException

Parameters:

deleteIdentityPoolRequest - Container for the necessary parameters to execute the DeleteIdentityPool service method on AmazonCognitoIdentity.

Throws:

InternalErrorException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

updateIdentityPool

UpdateIdentityPoolResult updateIdentityPool(UpdateIdentityPoolRequest updateIdentityPoolRequest)
                                            throws AmazonServiceException,
                                                   AmazonClientException

Parameters:

updateIdentityPoolRequest - Container for the necessary parameters to execute the UpdateIdentityPool service method on AmazonCognitoIdentity.

Returns:

The response from the UpdateIdentityPool service method, as returned by AmazonCognitoIdentity.

Throws:

ResourceConflictException

InternalErrorException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

getCredentialsForIdentity

GetCredentialsForIdentityResult getCredentialsForIdentity(GetCredentialsForIdentityRequest getCredentialsForIdentityRequest)
                                                          throws AmazonServiceException,
                                                                 AmazonClientException

Parameters:

getCredentialsForIdentityRequest - Container for the necessary parameters to execute the GetCredentialsForIdentity service method on AmazonCognitoIdentity.

Returns:

The response from the GetCredentialsForIdentity service method, as returned by AmazonCognitoIdentity.

Throws:

ResourceConflictException

InternalErrorException

InvalidIdentityPoolConfigurationException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

mergeDeveloperIdentities

MergeDeveloperIdentitiesResult mergeDeveloperIdentities(MergeDeveloperIdentitiesRequest mergeDeveloperIdentitiesRequest)
                                                        throws AmazonServiceException,
                                                               AmazonClientException

Parameters:

mergeDeveloperIdentitiesRequest - Container for the necessary parameters to execute the MergeDeveloperIdentities service method on AmazonCognitoIdentity.

Returns:

The response from the MergeDeveloperIdentities service method, as returned by AmazonCognitoIdentity.

Throws:

ResourceConflictException

InternalErrorException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

listIdentityPools

ListIdentityPoolsResult listIdentityPools(ListIdentityPoolsRequest listIdentityPoolsRequest)
                                          throws AmazonServiceException,
                                                 AmazonClientException

Parameters:

listIdentityPoolsRequest - Container for the necessary parameters to execute the ListIdentityPools service method on AmazonCognitoIdentity.

Returns:

The response from the ListIdentityPools service method, as returned by AmazonCognitoIdentity.

Throws:

InternalErrorException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

getOpenIdToken

GetOpenIdTokenResult getOpenIdToken(GetOpenIdTokenRequest getOpenIdTokenRequest)
                                    throws AmazonServiceException,
                                           AmazonClientException

Parameters:

getOpenIdTokenRequest - Container for the necessary parameters to execute the GetOpenIdToken service method on AmazonCognitoIdentity.

Returns:

The response from the GetOpenIdToken service method, as returned by AmazonCognitoIdentity.

Throws:

ResourceConflictException

InternalErrorException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

describeIdentity

DescribeIdentityResult describeIdentity(DescribeIdentityRequest describeIdentityRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

Parameters:

describeIdentityRequest - Container for the necessary parameters to execute the DescribeIdentity service method on AmazonCognitoIdentity.

Returns:

The response from the DescribeIdentity service method, as returned by AmazonCognitoIdentity.

Throws:

InternalErrorException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

lookupDeveloperIdentity

LookupDeveloperIdentityResult lookupDeveloperIdentity(LookupDeveloperIdentityRequest lookupDeveloperIdentityRequest)
                                                      throws AmazonServiceException,
                                                             AmazonClientException

Parameters:

lookupDeveloperIdentityRequest - Container for the necessary parameters to execute the LookupDeveloperIdentity service method on AmazonCognitoIdentity.

Returns:

The response from the LookupDeveloperIdentity service method, as returned by AmazonCognitoIdentity.

Throws:

ResourceConflictException

InternalErrorException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

setIdentityPoolRoles

void setIdentityPoolRoles(SetIdentityPoolRolesRequest setIdentityPoolRolesRequest)
                          throws AmazonServiceException,
                                 AmazonClientException

Parameters:

setIdentityPoolRolesRequest - Container for the necessary parameters to execute the SetIdentityPoolRoles service method on AmazonCognitoIdentity.

Throws:

ResourceConflictException

InternalErrorException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

unlinkIdentity

void unlinkIdentity(UnlinkIdentityRequest unlinkIdentityRequest)
                    throws AmazonServiceException,
                           AmazonClientException

Parameters:

unlinkIdentityRequest - Container for the necessary parameters to execute the UnlinkIdentity service method on AmazonCognitoIdentity.

Throws:

ResourceConflictException

InternalErrorException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

listIdentities

ListIdentitiesResult listIdentities(ListIdentitiesRequest listIdentitiesRequest)
                                    throws AmazonServiceException,
                                           AmazonClientException

Parameters:

listIdentitiesRequest - Container for the necessary parameters to execute the ListIdentities service method on AmazonCognitoIdentity.

Returns:

The response from the ListIdentities service method, as returned by AmazonCognitoIdentity.

Throws:

InternalErrorException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

getIdentityPoolRoles

GetIdentityPoolRolesResult getIdentityPoolRoles(GetIdentityPoolRolesRequest getIdentityPoolRolesRequest)
                                                throws AmazonServiceException,
                                                       AmazonClientException

Parameters:

getIdentityPoolRolesRequest - Container for the necessary parameters to execute the GetIdentityPoolRoles service method on AmazonCognitoIdentity.

Returns:

The response from the GetIdentityPoolRoles service method, as returned by AmazonCognitoIdentity.

Throws:

ResourceConflictException

InternalErrorException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

getOpenIdTokenForDeveloperIdentity

GetOpenIdTokenForDeveloperIdentityResult getOpenIdTokenForDeveloperIdentity(GetOpenIdTokenForDeveloperIdentityRequest getOpenIdTokenForDeveloperIdentityRequest)
                                                                            throws AmazonServiceException,
                                                                                   AmazonClientException

Parameters:

getOpenIdTokenForDeveloperIdentityRequest - Container for the necessary parameters to execute the GetOpenIdTokenForDeveloperIdentity service method on AmazonCognitoIdentity.

Returns:

The response from the GetOpenIdTokenForDeveloperIdentity service method, as returned by AmazonCognitoIdentity.

Throws:

ResourceConflictException

InternalErrorException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

DeveloperUserAlreadyRegisteredException

ResourceNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

createIdentityPool

CreateIdentityPoolResult createIdentityPool(CreateIdentityPoolRequest createIdentityPoolRequest)
                                            throws AmazonServiceException,
                                                   AmazonClientException

Parameters:

createIdentityPoolRequest - Container for the necessary parameters to execute the CreateIdentityPool service method on AmazonCognitoIdentity.

Returns:

The response from the CreateIdentityPool service method, as returned by AmazonCognitoIdentity.

Throws:

ResourceConflictException

InternalErrorException

LimitExceededException

NotAuthorizedException

InvalidParameterException

TooManyRequestsException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCognitoIdentity indicating either a problem with the data in the request, or a server side issue.

shutdown

void shutdown()

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.

getCachedResponseMetadata

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. 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.

Parameters:

request - The originally executed request.

Returns:

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