@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AmazonChimeSDKMessagingClient extends AmazonWebServiceClient implements AmazonChimeSDKMessaging
The Amazon Chime SDK messaging APIs in this section allow software developers to send and receive messages in custom messaging applications. These APIs depend on the frameworks provided by the Amazon Chime SDK identity APIs. For more information about the messaging APIs, see Amazon Chime SDK messaging.
LOGGING_AWS_REQUEST_METRICENDPOINT_PREFIXaddRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffsetpublic static AmazonChimeSDKMessagingClientBuilder builder()
public AssociateChannelFlowResult associateChannelFlow(AssociateChannelFlowRequest request)
Associates a channel flow with a channel. Once associated, all messages to that channel go through channel flow
processors. To stop processing, use the DisassociateChannelFlow API.
Only administrators or channel moderators can associate a channel flow. The x-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser or AppInstanceBot that
makes the API call as the value in the header.
associateChannelFlow in interface AmazonChimeSDKMessagingassociateChannelFlowRequest - BadRequestException - The input parameters don't match the service's restrictions.ForbiddenException - The client is permanently forbidden from making the request.NotFoundException - One or more of the resources in the request does not exist in the system.UnauthorizedClientException - The client is not currently authorized to make the request.ConflictException - The request could not be processed because of conflict in the current state of the resource.ThrottledClientException - The client exceeded its request rate limit.ServiceUnavailableException - The service is currently unavailable.ServiceFailureException - The service encountered an unexpected error.public BatchCreateChannelMembershipResult batchCreateChannelMembership(BatchCreateChannelMembershipRequest request)
Adds a specified number of users and bots to a channel.
batchCreateChannelMembership in interface AmazonChimeSDKMessagingbatchCreateChannelMembershipRequest - ServiceFailureException - The service encountered an unexpected error.ServiceUnavailableException - The service is currently unavailable.UnauthorizedClientException - The client is not currently authorized to make the request.BadRequestException - The input parameters don't match the service's restrictions.NotFoundException - One or more of the resources in the request does not exist in the system.ForbiddenException - The client is permanently forbidden from making the request.ThrottledClientException - The client exceeded its request rate limit.ResourceLimitExceededException - The request exceeds the resource limit.public ChannelFlowCallbackResult channelFlowCallback(ChannelFlowCallbackRequest request)
Calls back Amazon Chime SDK messaging with a processing response message. This should be invoked from the processor Lambda. This is a developer API.
You can return one of the following processing responses:
Update message content or metadata
Deny a message
Make no changes to the message
channelFlowCallback in interface AmazonChimeSDKMessagingchannelFlowCallbackRequest - 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.ConflictException - The request could not be processed because of conflict in the current state of the resource.ThrottledClientException - The client exceeded its request rate limit.ServiceUnavailableException - The service is currently unavailable.ServiceFailureException - The service encountered an unexpected error.public CreateChannelResult createChannel(CreateChannelRequest request)
Creates a channel to which you can add users and send messages.
Restriction: You can't change a channel's privacy.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
createChannel in interface AmazonChimeSDKMessagingcreateChannelRequest - 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.ConflictException - The request could not be processed because of conflict in the current state of the resource.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.public CreateChannelBanResult createChannelBan(CreateChannelBanRequest request)
Permanently bans a member from a channel. Moderators can't add banned members to a channel. To undo a ban, you
first have to DeleteChannelBan, and then CreateChannelMembership. Bans are cleaned up
when you delete users or channels.
If you ban a user who is already part of a channel, that user is automatically kicked from the channel.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
createChannelBan in interface AmazonChimeSDKMessagingcreateChannelBanRequest - 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.ConflictException - The request could not be processed because of conflict in the current state of the resource.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.public CreateChannelFlowResult createChannelFlow(CreateChannelFlowRequest request)
Creates a channel flow, a container for processors. Processors are AWS Lambda functions that perform actions on chat messages, such as stripping out profanity. You can associate channel flows with channels, and the processors in the channel flow then take action on all messages sent to that channel. This is a developer API.
Channel flows process the following items:
New and updated messages
Persistent and non-persistent messages
The Standard message type
Channel flows don't process Control or System messages. For more information about the message types provided by Chime SDK messaging, refer to Message types in the Amazon Chime developer guide.
createChannelFlow in interface AmazonChimeSDKMessagingcreateChannelFlowRequest - 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.ConflictException - The request could not be processed because of conflict in the current state of the resource.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.public CreateChannelMembershipResult createChannelMembership(CreateChannelMembershipRequest request)
Adds a member to a channel. The InvitedBy field in ChannelMembership is derived from
the request header. A channel member can:
List messages
Send messages
Receive messages
Edit their own messages
Leave the channel
Privacy settings impact this action as follows:
Public Channels: You do not need to be a member to list messages, but you must be a member to send messages.
Private Channels: You must be a member to list or send messages.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the
AppInstanceUserArn or AppInstanceBot that makes the API call as the value in the
header.
createChannelMembership in interface AmazonChimeSDKMessagingcreateChannelMembershipRequest - BadRequestException - The input parameters don't match the service's restrictions.NotFoundException - One or more of the resources in the request does not exist in the system.ForbiddenException - The client is permanently forbidden from making the request.UnauthorizedClientException - The client is not currently authorized to make the request.ConflictException - The request could not be processed because of conflict in the current state of the resource.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.public CreateChannelModeratorResult createChannelModerator(CreateChannelModeratorRequest request)
Creates a new ChannelModerator. A channel moderator can:
Add and remove other members of the channel.
Add and remove other moderators of the channel.
Add and remove user bans for the channel.
Redact messages in the channel.
List messages in the channel.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBotof the user that makes the API call as the value in the header.
createChannelModerator in interface AmazonChimeSDKMessagingcreateChannelModeratorRequest - 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.ConflictException - The request could not be processed because of conflict in the current state of the resource.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.public DeleteChannelResult deleteChannel(DeleteChannelRequest request)
Immediately makes a channel and its memberships inaccessible and marks them for deletion. This is an irreversible process.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the
AppInstanceUserArn or AppInstanceBot that makes the API call as the value in the
header.
deleteChannel in interface AmazonChimeSDKMessagingdeleteChannelRequest - BadRequestException - The input parameters don't match the service's restrictions.ForbiddenException - The client is permanently forbidden from making the request.ConflictException - The request could not be processed because of conflict in the current state of the resource.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.public DeleteChannelBanResult deleteChannelBan(DeleteChannelBanRequest request)
Removes a member from a channel's ban list.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
deleteChannelBan in interface AmazonChimeSDKMessagingdeleteChannelBanRequest - 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.public DeleteChannelFlowResult deleteChannelFlow(DeleteChannelFlowRequest request)
Deletes a channel flow, an irreversible process. This is a developer API.
This API works only when the channel flow is not associated with any channel. To get a list of all channels that
a channel flow is associated with, use the ListChannelsAssociatedWithChannelFlow API. Use the
DisassociateChannelFlow API to disassociate a channel flow from all channels.
deleteChannelFlow in interface AmazonChimeSDKMessagingdeleteChannelFlowRequest - 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.ConflictException - The request could not be processed because of conflict in the current state of the resource.ServiceUnavailableException - The service is currently unavailable.ServiceFailureException - The service encountered an unexpected error.public DeleteChannelMembershipResult deleteChannelMembership(DeleteChannelMembershipRequest request)
Removes a member from a channel.
The x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the
user that makes the API call as the value in the header.
deleteChannelMembership in interface AmazonChimeSDKMessagingdeleteChannelMembershipRequest - 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.ConflictException - The request could not be processed because of conflict in the current state of the resource.ThrottledClientException - The client exceeded its request rate limit.ServiceUnavailableException - The service is currently unavailable.ServiceFailureException - The service encountered an unexpected error.public DeleteChannelMessageResult deleteChannelMessage(DeleteChannelMessageRequest request)
Deletes a channel message. Only admins can perform this action. Deletion makes messages inaccessible immediately.
A background process deletes any revisions created by UpdateChannelMessage.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
deleteChannelMessage in interface AmazonChimeSDKMessagingdeleteChannelMessageRequest - 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.public DeleteChannelModeratorResult deleteChannelModerator(DeleteChannelModeratorRequest request)
Deletes a channel moderator.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
deleteChannelModerator in interface AmazonChimeSDKMessagingdeleteChannelModeratorRequest - 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.public DeleteMessagingStreamingConfigurationsResult deleteMessagingStreamingConfigurations(DeleteMessagingStreamingConfigurationsRequest request)
Deletes the streaming configurations for an AppInstance. For more information, see Streaming messaging data in the
Amazon Chime SDK Developer Guide.
deleteMessagingStreamingConfigurations in interface AmazonChimeSDKMessagingdeleteMessagingStreamingConfigurationsRequest - 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.public DescribeChannelResult describeChannel(DescribeChannelRequest request)
Returns the full details of a channel in an Amazon Chime AppInstance.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
describeChannel in interface AmazonChimeSDKMessagingdescribeChannelRequest - 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.public DescribeChannelBanResult describeChannelBan(DescribeChannelBanRequest request)
Returns the full details of a channel ban.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
describeChannelBan in interface AmazonChimeSDKMessagingdescribeChannelBanRequest - BadRequestException - The input parameters don't match the service's restrictions.ForbiddenException - The client is permanently forbidden from making the request.NotFoundException - One or more of the resources in the request does not exist in the system.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.public DescribeChannelFlowResult describeChannelFlow(DescribeChannelFlowRequest request)
Returns the full details of a channel flow in an Amazon Chime AppInstance. This is a developer API.
describeChannelFlow in interface AmazonChimeSDKMessagingdescribeChannelFlowRequest - 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.public DescribeChannelMembershipResult describeChannelMembership(DescribeChannelMembershipRequest request)
Returns the full details of a user's channel membership.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
describeChannelMembership in interface AmazonChimeSDKMessagingdescribeChannelMembershipRequest - BadRequestException - The input parameters don't match the service's restrictions.ForbiddenException - The client is permanently forbidden from making the request.NotFoundException - One or more of the resources in the request does not exist in the system.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.public DescribeChannelMembershipForAppInstanceUserResult describeChannelMembershipForAppInstanceUser(DescribeChannelMembershipForAppInstanceUserRequest request)
Returns the details of a channel based on the membership of the specified AppInstanceUser or
AppInstanceBot.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
describeChannelMembershipForAppInstanceUser in interface AmazonChimeSDKMessagingdescribeChannelMembershipForAppInstanceUserRequest - 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.public DescribeChannelModeratedByAppInstanceUserResult describeChannelModeratedByAppInstanceUser(DescribeChannelModeratedByAppInstanceUserRequest request)
Returns the full details of a channel moderated by the specified AppInstanceUser or
AppInstanceBot.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
describeChannelModeratedByAppInstanceUser in interface AmazonChimeSDKMessagingdescribeChannelModeratedByAppInstanceUserRequest - 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.public DescribeChannelModeratorResult describeChannelModerator(DescribeChannelModeratorRequest request)
Returns the full details of a single ChannelModerator.
The x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the
user that makes the API call as the value in the header.
describeChannelModerator in interface AmazonChimeSDKMessagingdescribeChannelModeratorRequest - BadRequestException - The input parameters don't match the service's restrictions.ForbiddenException - The client is permanently forbidden from making the request.NotFoundException - One or more of the resources in the request does not exist in the system.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.public DisassociateChannelFlowResult disassociateChannelFlow(DisassociateChannelFlowRequest request)
Disassociates a channel flow from all its channels. Once disassociated, all messages to that channel stop going through the channel flow processor.
Only administrators or channel moderators can disassociate a channel flow.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
disassociateChannelFlow in interface AmazonChimeSDKMessagingdisassociateChannelFlowRequest - BadRequestException - The input parameters don't match the service's restrictions.ForbiddenException - The client is permanently forbidden from making the request.NotFoundException - One or more of the resources in the request does not exist in the system.UnauthorizedClientException - The client is not currently authorized to make the request.ConflictException - The request could not be processed because of conflict in the current state of the resource.ThrottledClientException - The client exceeded its request rate limit.ServiceUnavailableException - The service is currently unavailable.ServiceFailureException - The service encountered an unexpected error.public GetChannelMembershipPreferencesResult getChannelMembershipPreferences(GetChannelMembershipPreferencesRequest request)
Gets the membership preferences of an AppInstanceUser or AppInstanceBot for the
specified channel. A user or a bot must be a member of the channel and own the membership in order to retrieve
membership preferences. Users or bots in the AppInstanceAdmin and channel moderator roles can't
retrieve preferences for other users or bots. Banned users or bots can't retrieve membership preferences for the
channel from which they are banned.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
getChannelMembershipPreferences in interface AmazonChimeSDKMessaginggetChannelMembershipPreferencesRequest - BadRequestException - The input parameters don't match the service's restrictions.UnauthorizedClientException - The client is not currently authorized to make the request.ForbiddenException - The client is permanently forbidden from making the request.ThrottledClientException - The client exceeded its request rate limit.ServiceUnavailableException - The service is currently unavailable.ServiceFailureException - The service encountered an unexpected error.public GetChannelMessageResult getChannelMessage(GetChannelMessageRequest request)
Gets the full details of a channel message.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
getChannelMessage in interface AmazonChimeSDKMessaginggetChannelMessageRequest - BadRequestException - The input parameters don't match the service's restrictions.ForbiddenException - The client is permanently forbidden from making the request.NotFoundException - One or more of the resources in the request does not exist in the system.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.public GetChannelMessageStatusResult getChannelMessageStatus(GetChannelMessageStatusRequest request)
Gets message status for a specified messageId. Use this API to determine the intermediate status of
messages going through channel flow processing. The API provides an alternative to retrieving message status if
the event was not received because a client wasn't connected to a websocket.
Messages can have any one of these statuses.
Message processed successfully
Ongoing processing
Processing failed
Message denied by the processor
This API does not return statuses for denied messages, because we don't store them once the processor denies them.
Only the message sender can invoke this API.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
getChannelMessageStatus in interface AmazonChimeSDKMessaginggetChannelMessageStatusRequest - 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.public GetMessagingSessionEndpointResult getMessagingSessionEndpoint(GetMessagingSessionEndpointRequest request)
The details of the endpoint for the messaging session.
getMessagingSessionEndpoint in interface AmazonChimeSDKMessaginggetMessagingSessionEndpointRequest - UnauthorizedClientException - The client is not currently authorized to make the request.ForbiddenException - The client is permanently forbidden from making the request.ThrottledClientException - The client exceeded its request rate limit.ServiceUnavailableException - The service is currently unavailable.ServiceFailureException - The service encountered an unexpected error.public GetMessagingStreamingConfigurationsResult getMessagingStreamingConfigurations(GetMessagingStreamingConfigurationsRequest request)
Retrieves the data streaming configuration for an AppInstance. For more information, see Streaming messaging data in the
Amazon Chime SDK Developer Guide.
getMessagingStreamingConfigurations in interface AmazonChimeSDKMessaginggetMessagingStreamingConfigurationsRequest - BadRequestException - The input parameters don't match the service's restrictions.ForbiddenException - The client is permanently forbidden from making the request.NotFoundException - One or more of the resources in the request does not exist in the system.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.public ListChannelBansResult listChannelBans(ListChannelBansRequest request)
Lists all the users and bots banned from a particular channel.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
listChannelBans in interface AmazonChimeSDKMessaginglistChannelBansRequest - 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.public ListChannelFlowsResult listChannelFlows(ListChannelFlowsRequest request)
Returns a paginated lists of all the channel flows created under a single Chime. This is a developer API.
listChannelFlows in interface AmazonChimeSDKMessaginglistChannelFlowsRequest - 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.public ListChannelMembershipsResult listChannelMemberships(ListChannelMembershipsRequest request)
Lists all channel memberships in a channel.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
If you want to list the channels to which a specific app instance user belongs, see the ListChannelMembershipsForAppInstanceUser API.
listChannelMemberships in interface AmazonChimeSDKMessaginglistChannelMembershipsRequest - 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.public ListChannelMembershipsForAppInstanceUserResult listChannelMembershipsForAppInstanceUser(ListChannelMembershipsForAppInstanceUserRequest request)
Lists all channels that an AppInstanceUser or AppInstanceBot is a part of. Only an
AppInstanceAdmin can call the API with a user ARN that is not their own.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
listChannelMembershipsForAppInstanceUser in interface AmazonChimeSDKMessaginglistChannelMembershipsForAppInstanceUserRequest - 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.public ListChannelMessagesResult listChannelMessages(ListChannelMessagesRequest request)
List all the messages in a channel. Returns a paginated list of ChannelMessages. By default, sorted
by creation timestamp in descending order.
Redacted messages appear in the results as empty, since they are only redacted, not deleted. Deleted messages do not appear in the results. This action always returns the latest version of an edited message.
Also, the x-amz-chime-bearer request header is mandatory. Use the ARN of the
AppInstanceUser or AppInstanceBot that makes the API call as the value in the header.
listChannelMessages in interface AmazonChimeSDKMessaginglistChannelMessagesRequest - 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.public ListChannelModeratorsResult listChannelModerators(ListChannelModeratorsRequest request)
Lists all the moderators for a channel.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
listChannelModerators in interface AmazonChimeSDKMessaginglistChannelModeratorsRequest - 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.public ListChannelsResult listChannels(ListChannelsRequest request)
Lists all Channels created under a single Chime App as a paginated list. You can specify filters to narrow results.
Functionality & restrictions
Use privacy = PUBLIC to retrieve all public channels in the account.
Only an AppInstanceAdmin can set privacy = PRIVATE to list the private channels in an
account.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
listChannels in interface AmazonChimeSDKMessaginglistChannelsRequest - 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.public ListChannelsAssociatedWithChannelFlowResult listChannelsAssociatedWithChannelFlow(ListChannelsAssociatedWithChannelFlowRequest request)
Lists all channels associated with a specified channel flow. You can associate a channel flow with multiple channels, but you can only associate a channel with one channel flow. This is a developer API.
listChannelsAssociatedWithChannelFlow in interface AmazonChimeSDKMessaginglistChannelsAssociatedWithChannelFlowRequest - 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.public ListChannelsModeratedByAppInstanceUserResult listChannelsModeratedByAppInstanceUser(ListChannelsModeratedByAppInstanceUserRequest request)
A list of the channels moderated by an AppInstanceUser.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
listChannelsModeratedByAppInstanceUser in interface AmazonChimeSDKMessaginglistChannelsModeratedByAppInstanceUserRequest - 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.public ListSubChannelsResult listSubChannels(ListSubChannelsRequest request)
Lists all the SubChannels in an elastic channel when given a channel ID. Available only to the app instance admins and channel moderators of elastic channels.
listSubChannels in interface AmazonChimeSDKMessaginglistSubChannelsRequest - 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.public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
Lists the tags applied to an Amazon Chime SDK messaging resource.
listTagsForResource in interface AmazonChimeSDKMessaginglistTagsForResourceRequest - 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.public PutChannelExpirationSettingsResult putChannelExpirationSettings(PutChannelExpirationSettingsRequest request)
Sets the number of days before the channel is automatically deleted.
A background process deletes expired channels within 6 hours of expiration. Actual deletion times may vary.
Expired channels that have not yet been deleted appear as active, and you can update their expiration settings. The system honors the new settings.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
putChannelExpirationSettings in interface AmazonChimeSDKMessagingputChannelExpirationSettingsRequest - BadRequestException - The input parameters don't match the service's restrictions.ForbiddenException - The client is permanently forbidden from making the request.ConflictException - The request could not be processed because of conflict in the current state of the resource.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.public PutChannelMembershipPreferencesResult putChannelMembershipPreferences(PutChannelMembershipPreferencesRequest request)
Sets the membership preferences of an AppInstanceUser or AppInstanceBot for the
specified channel. The user or bot must be a member of the channel. Only the user or bot who owns the membership
can set preferences. Users or bots in the AppInstanceAdmin and channel moderator roles can't set
preferences for other users. Banned users or bots can't set membership preferences for the channel from which
they are banned.
The x-amz-chime-bearer request header is mandatory. Use the ARN of an AppInstanceUser or
AppInstanceBot that makes the API call as the value in the header.
putChannelMembershipPreferences in interface AmazonChimeSDKMessagingputChannelMembershipPreferencesRequest - 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.UnauthorizedClientException - The client is not currently authorized to make the request.ForbiddenException - The client is permanently forbidden from making the request.ThrottledClientException - The client exceeded its request rate limit.ServiceUnavailableException - The service is currently unavailable.ServiceFailureException - The service encountered an unexpected error.public PutMessagingStreamingConfigurationsResult putMessagingStreamingConfigurations(PutMessagingStreamingConfigurationsRequest request)
Sets the data streaming configuration for an AppInstance. For more information, see Streaming messaging data in the
Amazon Chime SDK Developer Guide.
putMessagingStreamingConfigurations in interface AmazonChimeSDKMessagingputMessagingStreamingConfigurationsRequest - NotFoundException - One or more of the resources in the request does not exist in the system.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.ConflictException - The request could not be processed because of conflict in the current state of the resource.ServiceUnavailableException - The service is currently unavailable.ServiceFailureException - The service encountered an unexpected error.public RedactChannelMessageResult redactChannelMessage(RedactChannelMessageRequest request)
Redacts message content, but not metadata. The message exists in the back end, but the action returns null content, and the state shows as redacted.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
redactChannelMessage in interface AmazonChimeSDKMessagingredactChannelMessageRequest - BadRequestException - The input parameters don't match the service's restrictions.ForbiddenException - The client is permanently forbidden from making the request.ConflictException - The request could not be processed because of conflict in the current state of the resource.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.public SearchChannelsResult searchChannels(SearchChannelsRequest request)
Allows the ChimeBearer to search channels by channel members. Users or bots can search across the
channels that they belong to. Users in the AppInstanceAdmin role can search across all channels.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
searchChannels in interface AmazonChimeSDKMessagingsearchChannelsRequest - 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.public SendChannelMessageResult sendChannelMessage(SendChannelMessageRequest request)
Sends a message to a particular channel that the member is a part of.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
Also, STANDARD messages can be up to 4KB in size and contain metadata. Metadata is arbitrary, and
you can use it in a variety of ways, such as containing a link to an attachment.
CONTROL messages are limited to 30 bytes and do not contain metadata.
sendChannelMessage in interface AmazonChimeSDKMessagingsendChannelMessageRequest - 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.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.public TagResourceResult tagResource(TagResourceRequest request)
Applies the specified tags to the specified Amazon Chime SDK messaging resource.
tagResource in interface AmazonChimeSDKMessagingtagResourceRequest - 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.public UntagResourceResult untagResource(UntagResourceRequest request)
Removes the specified tags from the specified Amazon Chime SDK messaging resource.
untagResource in interface AmazonChimeSDKMessaginguntagResourceRequest - 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.public UpdateChannelResult updateChannel(UpdateChannelRequest request)
Update a channel's attributes.
Restriction: You can't change a channel's privacy.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
updateChannel in interface AmazonChimeSDKMessagingupdateChannelRequest - BadRequestException - The input parameters don't match the service's restrictions.ForbiddenException - The client is permanently forbidden from making the request.ConflictException - The request could not be processed because of conflict in the current state of the resource.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.public UpdateChannelFlowResult updateChannelFlow(UpdateChannelFlowRequest request)
Updates channel flow attributes. This is a developer API.
updateChannelFlow in interface AmazonChimeSDKMessagingupdateChannelFlowRequest - 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.ConflictException - The request could not be processed because of conflict in the current state of the resource.ThrottledClientException - The client exceeded its request rate limit.ServiceUnavailableException - The service is currently unavailable.ServiceFailureException - The service encountered an unexpected error.public UpdateChannelMessageResult updateChannelMessage(UpdateChannelMessageRequest request)
Updates the content of a message.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
updateChannelMessage in interface AmazonChimeSDKMessagingupdateChannelMessageRequest - 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.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.public UpdateChannelReadMarkerResult updateChannelReadMarker(UpdateChannelReadMarkerRequest request)
The details of the time when a user last read messages in a channel.
The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot that makes the API call as the value in the header.
updateChannelReadMarker in interface AmazonChimeSDKMessagingupdateChannelReadMarkerRequest - BadRequestException - The input parameters don't match the service's restrictions.ForbiddenException - The client is permanently forbidden from making the request.ConflictException - The request could not be processed because of conflict in the current state of the resource.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.public 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 the request.
getCachedResponseMetadata in interface AmazonChimeSDKMessagingrequest - The originally executed requestpublic void shutdown()
AmazonWebServiceClientshutdown in interface AmazonChimeSDKMessagingshutdown in class AmazonWebServiceClient