@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public interface AmazonChimeSDKIdentity
Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
AbstractAmazonChimeSDKIdentity
instead.
The Amazon Chime SDK Identity APIs in this section allow software developers to create and manage unique instances of their messaging applications. These APIs provide the overarching framework for creating and sending messages. For more information about the identity APIs, refer to Amazon Chime SDK identity.
Modifier and Type | Field and Description |
---|---|
static String |
ENDPOINT_PREFIX
The region metadata service name for computing region endpoints.
|
Modifier and Type | Method and Description |
---|---|
CreateAppInstanceResult |
createAppInstance(CreateAppInstanceRequest createAppInstanceRequest)
Creates an Amazon Chime SDK messaging
AppInstance under an AWS account. |
CreateAppInstanceAdminResult |
createAppInstanceAdmin(CreateAppInstanceAdminRequest createAppInstanceAdminRequest)
Promotes an
AppInstanceUser to an AppInstanceAdmin . |
CreateAppInstanceUserResult |
createAppInstanceUser(CreateAppInstanceUserRequest createAppInstanceUserRequest)
Creates a user under an Amazon Chime
AppInstance . |
DeleteAppInstanceResult |
deleteAppInstance(DeleteAppInstanceRequest deleteAppInstanceRequest)
Deletes an
AppInstance and all associated data asynchronously. |
DeleteAppInstanceAdminResult |
deleteAppInstanceAdmin(DeleteAppInstanceAdminRequest deleteAppInstanceAdminRequest)
Demotes an
AppInstanceAdmin to an AppInstanceUser . |
DeleteAppInstanceUserResult |
deleteAppInstanceUser(DeleteAppInstanceUserRequest deleteAppInstanceUserRequest)
Deletes an
AppInstanceUser . |
DeregisterAppInstanceUserEndpointResult |
deregisterAppInstanceUserEndpoint(DeregisterAppInstanceUserEndpointRequest deregisterAppInstanceUserEndpointRequest)
Deregisters an
AppInstanceUserEndpoint . |
DescribeAppInstanceResult |
describeAppInstance(DescribeAppInstanceRequest describeAppInstanceRequest)
Returns the full details of an
AppInstance . |
DescribeAppInstanceAdminResult |
describeAppInstanceAdmin(DescribeAppInstanceAdminRequest describeAppInstanceAdminRequest)
Returns the full details of an
AppInstanceAdmin . |
DescribeAppInstanceUserResult |
describeAppInstanceUser(DescribeAppInstanceUserRequest describeAppInstanceUserRequest)
Returns the full details of an
AppInstanceUser . |
DescribeAppInstanceUserEndpointResult |
describeAppInstanceUserEndpoint(DescribeAppInstanceUserEndpointRequest describeAppInstanceUserEndpointRequest)
Returns the full details of an
AppInstanceUserEndpoint . |
GetAppInstanceRetentionSettingsResult |
getAppInstanceRetentionSettings(GetAppInstanceRetentionSettingsRequest getAppInstanceRetentionSettingsRequest)
Gets the retention settings for an
AppInstance . |
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.
|
ListAppInstanceAdminsResult |
listAppInstanceAdmins(ListAppInstanceAdminsRequest listAppInstanceAdminsRequest)
Returns a list of the administrators in the
AppInstance . |
ListAppInstancesResult |
listAppInstances(ListAppInstancesRequest listAppInstancesRequest)
Lists all Amazon Chime
AppInstance s created under a single AWS account. |
ListAppInstanceUserEndpointsResult |
listAppInstanceUserEndpoints(ListAppInstanceUserEndpointsRequest listAppInstanceUserEndpointsRequest)
Lists all the
AppInstanceUserEndpoints created under a single AppInstanceUser . |
ListAppInstanceUsersResult |
listAppInstanceUsers(ListAppInstanceUsersRequest listAppInstanceUsersRequest)
List all
AppInstanceUsers created under a single AppInstance . |
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Lists the tags applied to an Amazon Chime SDK identity resource.
|
PutAppInstanceRetentionSettingsResult |
putAppInstanceRetentionSettings(PutAppInstanceRetentionSettingsRequest putAppInstanceRetentionSettingsRequest)
Sets the amount of time in days that a given
AppInstance retains data. |
RegisterAppInstanceUserEndpointResult |
registerAppInstanceUserEndpoint(RegisterAppInstanceUserEndpointRequest registerAppInstanceUserEndpointRequest)
Registers an endpoint under an Amazon Chime
AppInstanceUser . |
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
TagResourceResult |
tagResource(TagResourceRequest tagResourceRequest)
Applies the specified tags to the specified Amazon Chime SDK identity resource.
|
UntagResourceResult |
untagResource(UntagResourceRequest untagResourceRequest)
Removes the specified tags from the specified Amazon Chime SDK identity resource.
|
UpdateAppInstanceResult |
updateAppInstance(UpdateAppInstanceRequest updateAppInstanceRequest)
Updates
AppInstance metadata. |
UpdateAppInstanceUserResult |
updateAppInstanceUser(UpdateAppInstanceUserRequest updateAppInstanceUserRequest)
Updates the details of an
AppInstanceUser . |
UpdateAppInstanceUserEndpointResult |
updateAppInstanceUserEndpoint(UpdateAppInstanceUserEndpointRequest updateAppInstanceUserEndpointRequest)
Updates the details of an
AppInstanceUserEndpoint . |
static final String ENDPOINT_PREFIX
CreateAppInstanceResult createAppInstance(CreateAppInstanceRequest createAppInstanceRequest)
Creates an Amazon Chime SDK messaging AppInstance
under an AWS account. Only SDK messaging customers
use this API. CreateAppInstance
supports idempotency behavior as described in the AWS API Standard.
identity
createAppInstanceRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ConflictException
- The request could not be processed because of conflict in the current state of the resource.ForbiddenException
- The client is permanently forbidden from making the request.ResourceLimitExceededException
- The request exceeds the resource limit.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.CreateAppInstanceAdminResult createAppInstanceAdmin(CreateAppInstanceAdminRequest createAppInstanceAdminRequest)
Promotes an AppInstanceUser
to an AppInstanceAdmin
. The promoted user can perform the
following actions.
ChannelModerator
actions across all channels in the AppInstance
.
DeleteChannelMessage
actions.
Only an AppInstanceUser
can be promoted to an AppInstanceAdmin
role.
createAppInstanceAdminRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ConflictException
- The request could not be processed because of conflict in the current state of the resource.ForbiddenException
- The client is permanently forbidden from making the request.ResourceLimitExceededException
- The request exceeds the resource limit.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.CreateAppInstanceUserResult createAppInstanceUser(CreateAppInstanceUserRequest createAppInstanceUserRequest)
Creates a user under an Amazon Chime AppInstance
. The request consists of a unique
appInstanceUserId
and Name
for that user.
createAppInstanceUserRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ConflictException
- The request could not be processed because of conflict in the current state of the resource.ForbiddenException
- The client is permanently forbidden from making the request.ResourceLimitExceededException
- The request exceeds the resource limit.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.DeleteAppInstanceResult deleteAppInstance(DeleteAppInstanceRequest deleteAppInstanceRequest)
Deletes an AppInstance
and all associated data asynchronously.
deleteAppInstanceRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.ResourceLimitExceededException
- The request exceeds the resource limit.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.DeleteAppInstanceAdminResult deleteAppInstanceAdmin(DeleteAppInstanceAdminRequest deleteAppInstanceAdminRequest)
Demotes an AppInstanceAdmin
to an AppInstanceUser
. This action does not delete the
user.
deleteAppInstanceAdminRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ConflictException
- The request could not be processed because of conflict in the current state of the resource.ForbiddenException
- The client is permanently forbidden from making the request.ResourceLimitExceededException
- The request exceeds the resource limit.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.DeleteAppInstanceUserResult deleteAppInstanceUser(DeleteAppInstanceUserRequest deleteAppInstanceUserRequest)
Deletes an AppInstanceUser
.
deleteAppInstanceUserRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ConflictException
- The request could not be processed because of conflict in the current state of the resource.ForbiddenException
- The client is permanently forbidden from making the request.ResourceLimitExceededException
- The request exceeds the resource limit.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.DeregisterAppInstanceUserEndpointResult deregisterAppInstanceUserEndpoint(DeregisterAppInstanceUserEndpointRequest deregisterAppInstanceUserEndpointRequest)
Deregisters an AppInstanceUserEndpoint
.
deregisterAppInstanceUserEndpointRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.DescribeAppInstanceResult describeAppInstance(DescribeAppInstanceRequest describeAppInstanceRequest)
Returns the full details of an AppInstance
.
describeAppInstanceRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.DescribeAppInstanceAdminResult describeAppInstanceAdmin(DescribeAppInstanceAdminRequest describeAppInstanceAdminRequest)
Returns the full details of an AppInstanceAdmin
.
describeAppInstanceAdminRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.DescribeAppInstanceUserResult describeAppInstanceUser(DescribeAppInstanceUserRequest describeAppInstanceUserRequest)
Returns the full details of an AppInstanceUser
.
describeAppInstanceUserRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.DescribeAppInstanceUserEndpointResult describeAppInstanceUserEndpoint(DescribeAppInstanceUserEndpointRequest describeAppInstanceUserEndpointRequest)
Returns the full details of an AppInstanceUserEndpoint
.
describeAppInstanceUserEndpointRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.GetAppInstanceRetentionSettingsResult getAppInstanceRetentionSettings(GetAppInstanceRetentionSettingsRequest getAppInstanceRetentionSettingsRequest)
Gets the retention settings for an AppInstance
.
getAppInstanceRetentionSettingsRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.ListAppInstanceAdminsResult listAppInstanceAdmins(ListAppInstanceAdminsRequest listAppInstanceAdminsRequest)
Returns a list of the administrators in the AppInstance
.
listAppInstanceAdminsRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.ResourceLimitExceededException
- The request exceeds the resource limit.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.ListAppInstanceUserEndpointsResult listAppInstanceUserEndpoints(ListAppInstanceUserEndpointsRequest listAppInstanceUserEndpointsRequest)
Lists all the AppInstanceUserEndpoints
created under a single AppInstanceUser
.
listAppInstanceUserEndpointsRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.ListAppInstanceUsersResult listAppInstanceUsers(ListAppInstanceUsersRequest listAppInstanceUsersRequest)
List all AppInstanceUsers
created under a single AppInstance
.
listAppInstanceUsersRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.ListAppInstancesResult listAppInstances(ListAppInstancesRequest listAppInstancesRequest)
Lists all Amazon Chime AppInstance
s created under a single AWS account.
listAppInstancesRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Lists the tags applied to an Amazon Chime SDK identity resource.
listTagsForResourceRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.UnauthorizedClientException
- The client is not currently authorized to make the request.ThrottledClientException
- The client exceeded its request rate limit.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.PutAppInstanceRetentionSettingsResult putAppInstanceRetentionSettings(PutAppInstanceRetentionSettingsRequest putAppInstanceRetentionSettingsRequest)
Sets the amount of time in days that a given AppInstance
retains data.
putAppInstanceRetentionSettingsRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.RegisterAppInstanceUserEndpointResult registerAppInstanceUserEndpoint(RegisterAppInstanceUserEndpointRequest registerAppInstanceUserEndpointRequest)
Registers an endpoint under an Amazon Chime AppInstanceUser
. The endpoint receives messages for a
user. For push notifications, the endpoint is a mobile device used to receive mobile push notifications for a
user.
registerAppInstanceUserEndpointRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ConflictException
- The request could not be processed because of conflict in the current state of the resource.ForbiddenException
- The client is permanently forbidden from making the request.ResourceLimitExceededException
- The request exceeds the resource limit.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.TagResourceResult tagResource(TagResourceRequest tagResourceRequest)
Applies the specified tags to the specified Amazon Chime SDK identity resource.
tagResourceRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.UnauthorizedClientException
- The client is not currently authorized to make the request.ResourceLimitExceededException
- The request exceeds the resource limit.ThrottledClientException
- The client exceeded its request rate limit.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest)
Removes the specified tags from the specified Amazon Chime SDK identity resource.
untagResourceRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ForbiddenException
- The client is permanently forbidden from making the request.UnauthorizedClientException
- The client is not currently authorized to make the request.ThrottledClientException
- The client exceeded its request rate limit.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.UpdateAppInstanceResult updateAppInstance(UpdateAppInstanceRequest updateAppInstanceRequest)
Updates AppInstance
metadata.
updateAppInstanceRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ConflictException
- The request could not be processed because of conflict in the current state of the resource.ForbiddenException
- The client is permanently forbidden from making the request.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.UpdateAppInstanceUserResult updateAppInstanceUser(UpdateAppInstanceUserRequest updateAppInstanceUserRequest)
Updates the details of an AppInstanceUser
. You can update names and metadata.
updateAppInstanceUserRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ConflictException
- The request could not be processed because of conflict in the current state of the resource.ForbiddenException
- The client is permanently forbidden from making the request.ResourceLimitExceededException
- The request exceeds the resource limit.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.UpdateAppInstanceUserEndpointResult updateAppInstanceUserEndpoint(UpdateAppInstanceUserEndpointRequest updateAppInstanceUserEndpointRequest)
Updates the details of an AppInstanceUserEndpoint
. You can update the name and
AllowMessage
values.
updateAppInstanceUserEndpointRequest
- BadRequestException
- The input parameters don't match the service's restrictions.ConflictException
- The request could not be processed because of conflict in the current state of the resource.ForbiddenException
- The client is permanently forbidden from making the request.ThrottledClientException
- The client exceeded its request rate limit.UnauthorizedClientException
- The client is not currently authorized to make the request.ServiceUnavailableException
- The service is currently unavailable.ServiceFailureException
- The service encountered an unexpected error.void shutdown()
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
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.
request
- The originally executed request.