@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AbstractAmazonChimeSDKMessaging extends Object implements AmazonChimeSDKMessaging
AmazonChimeSDKMessaging. Convenient method forms pass through to the corresponding
overload that takes a request object, which throws an UnsupportedOperationException.ENDPOINT_PREFIXpublic AssociateChannelFlowResult associateChannelFlow(AssociateChannelFlowRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic BatchCreateChannelMembershipResult batchCreateChannelMembership(BatchCreateChannelMembershipRequest request)
AmazonChimeSDKMessagingAdds a specified number of users and bots to a channel.
batchCreateChannelMembership in interface AmazonChimeSDKMessagingpublic ChannelFlowCallbackResult channelFlowCallback(ChannelFlowCallbackRequest request)
AmazonChimeSDKMessagingCalls 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 AmazonChimeSDKMessagingpublic CreateChannelResult createChannel(CreateChannelRequest request)
AmazonChimeSDKMessagingCreates 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 AmazonChimeSDKMessagingpublic CreateChannelBanResult createChannelBan(CreateChannelBanRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic CreateChannelFlowResult createChannelFlow(CreateChannelFlowRequest request)
AmazonChimeSDKMessagingCreates 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 AmazonChimeSDKMessagingpublic CreateChannelMembershipResult createChannelMembership(CreateChannelMembershipRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic CreateChannelModeratorResult createChannelModerator(CreateChannelModeratorRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic DeleteChannelResult deleteChannel(DeleteChannelRequest request)
AmazonChimeSDKMessagingImmediately 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 AmazonChimeSDKMessagingpublic DeleteChannelBanResult deleteChannelBan(DeleteChannelBanRequest request)
AmazonChimeSDKMessagingRemoves 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 AmazonChimeSDKMessagingpublic DeleteChannelFlowResult deleteChannelFlow(DeleteChannelFlowRequest request)
AmazonChimeSDKMessagingDeletes 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 AmazonChimeSDKMessagingpublic DeleteChannelMembershipResult deleteChannelMembership(DeleteChannelMembershipRequest request)
AmazonChimeSDKMessagingRemoves 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 AmazonChimeSDKMessagingpublic DeleteChannelMessageResult deleteChannelMessage(DeleteChannelMessageRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic DeleteChannelModeratorResult deleteChannelModerator(DeleteChannelModeratorRequest request)
AmazonChimeSDKMessagingDeletes 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 AmazonChimeSDKMessagingpublic DeleteMessagingStreamingConfigurationsResult deleteMessagingStreamingConfigurations(DeleteMessagingStreamingConfigurationsRequest request)
AmazonChimeSDKMessaging
Deletes the streaming configurations for an AppInstance. For more information, see Streaming messaging data in the
Amazon Chime SDK Developer Guide.
deleteMessagingStreamingConfigurations in interface AmazonChimeSDKMessagingpublic DescribeChannelResult describeChannel(DescribeChannelRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic DescribeChannelBanResult describeChannelBan(DescribeChannelBanRequest request)
AmazonChimeSDKMessagingReturns 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 AmazonChimeSDKMessagingpublic DescribeChannelFlowResult describeChannelFlow(DescribeChannelFlowRequest request)
AmazonChimeSDKMessaging
Returns the full details of a channel flow in an Amazon Chime AppInstance. This is a developer API.
describeChannelFlow in interface AmazonChimeSDKMessagingpublic DescribeChannelMembershipResult describeChannelMembership(DescribeChannelMembershipRequest request)
AmazonChimeSDKMessagingReturns 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 AmazonChimeSDKMessagingpublic DescribeChannelMembershipForAppInstanceUserResult describeChannelMembershipForAppInstanceUser(DescribeChannelMembershipForAppInstanceUserRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic DescribeChannelModeratedByAppInstanceUserResult describeChannelModeratedByAppInstanceUser(DescribeChannelModeratedByAppInstanceUserRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic DescribeChannelModeratorResult describeChannelModerator(DescribeChannelModeratorRequest request)
AmazonChimeSDKMessagingReturns 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 AmazonChimeSDKMessagingpublic DisassociateChannelFlowResult disassociateChannelFlow(DisassociateChannelFlowRequest request)
AmazonChimeSDKMessagingDisassociates 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 AmazonChimeSDKMessagingpublic GetChannelMembershipPreferencesResult getChannelMembershipPreferences(GetChannelMembershipPreferencesRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic GetChannelMessageResult getChannelMessage(GetChannelMessageRequest request)
AmazonChimeSDKMessagingGets 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 AmazonChimeSDKMessagingpublic GetChannelMessageStatusResult getChannelMessageStatus(GetChannelMessageStatusRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic GetMessagingSessionEndpointResult getMessagingSessionEndpoint(GetMessagingSessionEndpointRequest request)
AmazonChimeSDKMessagingThe details of the endpoint for the messaging session.
getMessagingSessionEndpoint in interface AmazonChimeSDKMessagingpublic GetMessagingStreamingConfigurationsResult getMessagingStreamingConfigurations(GetMessagingStreamingConfigurationsRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic ListChannelBansResult listChannelBans(ListChannelBansRequest request)
AmazonChimeSDKMessagingLists 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 AmazonChimeSDKMessagingpublic ListChannelFlowsResult listChannelFlows(ListChannelFlowsRequest request)
AmazonChimeSDKMessagingReturns a paginated lists of all the channel flows created under a single Chime. This is a developer API.
listChannelFlows in interface AmazonChimeSDKMessagingpublic ListChannelMembershipsResult listChannelMemberships(ListChannelMembershipsRequest request)
AmazonChimeSDKMessagingLists 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 AmazonChimeSDKMessagingpublic ListChannelMembershipsForAppInstanceUserResult listChannelMembershipsForAppInstanceUser(ListChannelMembershipsForAppInstanceUserRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic ListChannelMessagesResult listChannelMessages(ListChannelMessagesRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic ListChannelModeratorsResult listChannelModerators(ListChannelModeratorsRequest request)
AmazonChimeSDKMessagingLists 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 AmazonChimeSDKMessagingpublic ListChannelsResult listChannels(ListChannelsRequest request)
AmazonChimeSDKMessagingLists 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 AmazonChimeSDKMessagingpublic ListChannelsAssociatedWithChannelFlowResult listChannelsAssociatedWithChannelFlow(ListChannelsAssociatedWithChannelFlowRequest request)
AmazonChimeSDKMessagingLists 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 AmazonChimeSDKMessagingpublic ListChannelsModeratedByAppInstanceUserResult listChannelsModeratedByAppInstanceUser(ListChannelsModeratedByAppInstanceUserRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic ListSubChannelsResult listSubChannels(ListSubChannelsRequest request)
AmazonChimeSDKMessagingLists 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 AmazonChimeSDKMessagingpublic ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
AmazonChimeSDKMessagingLists the tags applied to an Amazon Chime SDK messaging resource.
listTagsForResource in interface AmazonChimeSDKMessagingpublic PutChannelExpirationSettingsResult putChannelExpirationSettings(PutChannelExpirationSettingsRequest request)
AmazonChimeSDKMessagingSets 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 AmazonChimeSDKMessagingpublic PutChannelMembershipPreferencesResult putChannelMembershipPreferences(PutChannelMembershipPreferencesRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic PutMessagingStreamingConfigurationsResult putMessagingStreamingConfigurations(PutMessagingStreamingConfigurationsRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic RedactChannelMessageResult redactChannelMessage(RedactChannelMessageRequest request)
AmazonChimeSDKMessagingRedacts 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 AmazonChimeSDKMessagingpublic SearchChannelsResult searchChannels(SearchChannelsRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessagingpublic SendChannelMessageResult sendChannelMessage(SendChannelMessageRequest request)
AmazonChimeSDKMessagingSends 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 AmazonChimeSDKMessagingpublic TagResourceResult tagResource(TagResourceRequest request)
AmazonChimeSDKMessagingApplies the specified tags to the specified Amazon Chime SDK messaging resource.
tagResource in interface AmazonChimeSDKMessagingpublic UntagResourceResult untagResource(UntagResourceRequest request)
AmazonChimeSDKMessagingRemoves the specified tags from the specified Amazon Chime SDK messaging resource.
untagResource in interface AmazonChimeSDKMessagingpublic UpdateChannelResult updateChannel(UpdateChannelRequest request)
AmazonChimeSDKMessagingUpdate 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 AmazonChimeSDKMessagingpublic UpdateChannelFlowResult updateChannelFlow(UpdateChannelFlowRequest request)
AmazonChimeSDKMessagingUpdates channel flow attributes. This is a developer API.
updateChannelFlow in interface AmazonChimeSDKMessagingpublic UpdateChannelMessageResult updateChannelMessage(UpdateChannelMessageRequest request)
AmazonChimeSDKMessagingUpdates 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 AmazonChimeSDKMessagingpublic UpdateChannelReadMarkerResult updateChannelReadMarker(UpdateChannelReadMarkerRequest request)
AmazonChimeSDKMessagingThe 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 AmazonChimeSDKMessagingpublic void shutdown()
AmazonChimeSDKMessagingshutdown in interface AmazonChimeSDKMessagingpublic ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
AmazonChimeSDKMessagingResponse 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.
getCachedResponseMetadata in interface AmazonChimeSDKMessagingrequest - The originally executed request.