@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_PREFIX
public 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 AppInstanceUserArn
of the user that makes the API call as the
value in the header.
associateChannelFlow
in interface AmazonChimeSDKMessaging
public BatchCreateChannelMembershipResult batchCreateChannelMembership(BatchCreateChannelMembershipRequest request)
AmazonChimeSDKMessaging
Adds a specified number of users to a channel.
batchCreateChannelMembership
in interface AmazonChimeSDKMessaging
public ChannelFlowCallbackResult channelFlowCallback(ChannelFlowCallbackRequest request)
AmazonChimeSDKMessaging
Calls back 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 AmazonChimeSDKMessaging
public CreateChannelResult createChannel(CreateChannelRequest request)
AmazonChimeSDKMessaging
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 AppInstanceUserArn
of the
user that makes the API call as the value in the header.
createChannel
in interface AmazonChimeSDKMessaging
public 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 AppInstanceUserArn
of the
user that makes the API call as the value in the header.
createChannelBan
in interface AmazonChimeSDKMessaging
public CreateChannelFlowResult createChannelFlow(CreateChannelFlowRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessaging
public CreateChannelMembershipResult createChannelMembership(CreateChannelMembershipRequest request)
AmazonChimeSDKMessaging
Adds a user 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 AppInstanceUserArn
of the
user that makes the API call as the value in the header.
createChannelMembership
in interface AmazonChimeSDKMessaging
public 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 AppInstanceUserArn
of the
user that makes the API call as the value in the header.
createChannelModerator
in interface AmazonChimeSDKMessaging
public DeleteChannelResult deleteChannel(DeleteChannelRequest request)
AmazonChimeSDKMessaging
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 AppInstanceUserArn
of the
user that makes the API call as the value in the header.
deleteChannel
in interface AmazonChimeSDKMessaging
public DeleteChannelBanResult deleteChannelBan(DeleteChannelBanRequest request)
AmazonChimeSDKMessaging
Removes a user from a channel's ban list.
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.
deleteChannelBan
in interface AmazonChimeSDKMessaging
public DeleteChannelFlowResult deleteChannelFlow(DeleteChannelFlowRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessaging
public DeleteChannelMembershipResult deleteChannelMembership(DeleteChannelMembershipRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessaging
public 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 AppInstanceUserArn
of the
user that makes the API call as the value in the header.
deleteChannelMessage
in interface AmazonChimeSDKMessaging
public DeleteChannelModeratorResult deleteChannelModerator(DeleteChannelModeratorRequest request)
AmazonChimeSDKMessaging
Deletes a channel moderator.
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.
deleteChannelModerator
in interface AmazonChimeSDKMessaging
public 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 AppInstanceUserArn
of the
user that makes the API call as the value in the header.
describeChannel
in interface AmazonChimeSDKMessaging
public DescribeChannelBanResult describeChannelBan(DescribeChannelBanRequest request)
AmazonChimeSDKMessaging
Returns the full details of a channel ban.
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.
describeChannelBan
in interface AmazonChimeSDKMessaging
public 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 AmazonChimeSDKMessaging
public DescribeChannelMembershipResult describeChannelMembership(DescribeChannelMembershipRequest request)
AmazonChimeSDKMessaging
Returns the full details of a user's channel membership.
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.
describeChannelMembership
in interface AmazonChimeSDKMessaging
public DescribeChannelMembershipForAppInstanceUserResult describeChannelMembershipForAppInstanceUser(DescribeChannelMembershipForAppInstanceUserRequest request)
AmazonChimeSDKMessaging
Returns the details of a channel based on the membership of the specified AppInstanceUser
.
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.
describeChannelMembershipForAppInstanceUser
in interface AmazonChimeSDKMessaging
public DescribeChannelModeratedByAppInstanceUserResult describeChannelModeratedByAppInstanceUser(DescribeChannelModeratedByAppInstanceUserRequest request)
AmazonChimeSDKMessaging
Returns the full details of a channel moderated by the specified AppInstanceUser
.
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.
describeChannelModeratedByAppInstanceUser
in interface AmazonChimeSDKMessaging
public DescribeChannelModeratorResult describeChannelModerator(DescribeChannelModeratorRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessaging
public DisassociateChannelFlowResult disassociateChannelFlow(DisassociateChannelFlowRequest request)
AmazonChimeSDKMessaging
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 AppInstanceUserArn
of the user that makes the API call as the
value in the header.
disassociateChannelFlow
in interface AmazonChimeSDKMessaging
public GetChannelMembershipPreferencesResult getChannelMembershipPreferences(GetChannelMembershipPreferencesRequest request)
AmazonChimeSDKMessaging
Gets the membership preferences of an AppInstanceUser
for the specified channel. The
AppInstanceUser
must be a member of the channel. Only the AppInstanceUser
who owns the
membership can retrieve preferences. Users in the AppInstanceAdmin
and channel moderator roles can't
retrieve preferences for other users. Banned users can't retrieve membership preferences for the channel from
which they are banned.
getChannelMembershipPreferences
in interface AmazonChimeSDKMessaging
public GetChannelMessageResult getChannelMessage(GetChannelMessageRequest request)
AmazonChimeSDKMessaging
Gets the full details of a channel message.
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.
getChannelMessage
in interface AmazonChimeSDKMessaging
public 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
Messasge 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 AppInstanceUserArn
of the
user that makes the API call as the value in the header
getChannelMessageStatus
in interface AmazonChimeSDKMessaging
public GetMessagingSessionEndpointResult getMessagingSessionEndpoint(GetMessagingSessionEndpointRequest request)
AmazonChimeSDKMessaging
The details of the endpoint for the messaging session.
getMessagingSessionEndpoint
in interface AmazonChimeSDKMessaging
public ListChannelBansResult listChannelBans(ListChannelBansRequest request)
AmazonChimeSDKMessaging
Lists all the users banned from a particular 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.
listChannelBans
in interface AmazonChimeSDKMessaging
public ListChannelFlowsResult listChannelFlows(ListChannelFlowsRequest request)
AmazonChimeSDKMessaging
Returns a paginated lists of all the channel flows created under a single Chime. This is a developer API.
listChannelFlows
in interface AmazonChimeSDKMessaging
public ListChannelMembershipsResult listChannelMemberships(ListChannelMembershipsRequest request)
AmazonChimeSDKMessaging
Lists all channel memberships in 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.
If you want to list the channels to which a specific app instance user belongs, see the ListChannelMembershipsForAppInstanceUser API.
listChannelMemberships
in interface AmazonChimeSDKMessaging
public ListChannelMembershipsForAppInstanceUserResult listChannelMembershipsForAppInstanceUser(ListChannelMembershipsForAppInstanceUserRequest request)
AmazonChimeSDKMessaging
Lists all channels that a particular AppInstanceUser
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 AppInstanceUserArn
of the
user that makes the API call as the value in the header.
listChannelMembershipsForAppInstanceUser
in interface AmazonChimeSDKMessaging
public 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 AppInstanceUserArn
of the user
that makes the API call as the value in the header.
listChannelMessages
in interface AmazonChimeSDKMessaging
public ListChannelModeratorsResult listChannelModerators(ListChannelModeratorsRequest request)
AmazonChimeSDKMessaging
Lists all the moderators for 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.
listChannelModerators
in interface AmazonChimeSDKMessaging
public ListChannelsResult listChannels(ListChannelsRequest request)
AmazonChimeSDKMessaging
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 AppInstanceUserArn
of the
user that makes the API call as the value in the header.
listChannels
in interface AmazonChimeSDKMessaging
public ListChannelsAssociatedWithChannelFlowResult listChannelsAssociatedWithChannelFlow(ListChannelsAssociatedWithChannelFlowRequest request)
AmazonChimeSDKMessaging
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 AmazonChimeSDKMessaging
public 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 AppInstanceUserArn
of the
user that makes the API call as the value in the header.
listChannelsModeratedByAppInstanceUser
in interface AmazonChimeSDKMessaging
public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
AmazonChimeSDKMessaging
Lists the tags applied to an Amazon Chime SDK messaging resource.
listTagsForResource
in interface AmazonChimeSDKMessaging
public PutChannelMembershipPreferencesResult putChannelMembershipPreferences(PutChannelMembershipPreferencesRequest request)
AmazonChimeSDKMessaging
Sets the membership preferences of an AppInstanceUser
for the specified channel. The
AppInstanceUser
must be a member of the channel. Only the AppInstanceUser
who owns the
membership can set preferences. Users in the AppInstanceAdmin
and channel moderator roles can't set
preferences for other users. Banned users can't set membership preferences for the channel from which they are
banned.
putChannelMembershipPreferences
in interface AmazonChimeSDKMessaging
public RedactChannelMessageResult redactChannelMessage(RedactChannelMessageRequest request)
AmazonChimeSDKMessaging
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 AppInstanceUserArn
of the
user that makes the API call as the value in the header.
redactChannelMessage
in interface AmazonChimeSDKMessaging
public SendChannelMessageResult sendChannelMessage(SendChannelMessageRequest request)
AmazonChimeSDKMessaging
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 AppInstanceUserArn
of the
user that makes the API call as the value in the header.
Also, STANDARD
messages can contain 4KB of data and the 1KB of metadata. CONTROL
messages can contain 30 bytes of data and no metadata.
sendChannelMessage
in interface AmazonChimeSDKMessaging
public TagResourceResult tagResource(TagResourceRequest request)
AmazonChimeSDKMessaging
Applies the specified tags to the specified Amazon Chime SDK messaging resource.
tagResource
in interface AmazonChimeSDKMessaging
public UntagResourceResult untagResource(UntagResourceRequest request)
AmazonChimeSDKMessaging
Removes the specified tags from the specified Amazon Chime SDK messaging resource.
untagResource
in interface AmazonChimeSDKMessaging
public UpdateChannelResult updateChannel(UpdateChannelRequest request)
AmazonChimeSDKMessaging
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 AppInstanceUserArn
of the
user that makes the API call as the value in the header.
updateChannel
in interface AmazonChimeSDKMessaging
public UpdateChannelFlowResult updateChannelFlow(UpdateChannelFlowRequest request)
AmazonChimeSDKMessaging
Updates channel flow attributes. This is a developer API.
updateChannelFlow
in interface AmazonChimeSDKMessaging
public UpdateChannelMessageResult updateChannelMessage(UpdateChannelMessageRequest request)
AmazonChimeSDKMessaging
Updates the content of a message.
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.
updateChannelMessage
in interface AmazonChimeSDKMessaging
public UpdateChannelReadMarkerResult updateChannelReadMarker(UpdateChannelReadMarkerRequest request)
AmazonChimeSDKMessaging
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 AppInstanceUserArn
of the
user that makes the API call as the value in the header.
updateChannelReadMarker
in interface AmazonChimeSDKMessaging
public void shutdown()
AmazonChimeSDKMessaging
shutdown
in interface AmazonChimeSDKMessaging
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
AmazonChimeSDKMessaging
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.
getCachedResponseMetadata
in interface AmazonChimeSDKMessaging
request
- The originally executed request.