Skip to main content

channel_memberships_for_app_instance_users

Creates, updates, deletes, gets or lists a channel_memberships_for_app_instance_users resource.

Overview

Namechannel_memberships_for_app_instance_users
TypeResource
Idaws.chime_sdk_messaging.channel_memberships_for_app_instance_users

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
channel_membershipsarrayThe information for the requested channel memberships.
next_tokenstringThe token passed by previous API calls until all requested users are returned. (pattern: <code>.*</code>)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_channel_memberships_for_app_instance_userselectx-amz-chime-bearer, regionapp-instance-user-arn, max-results, next-tokenLists 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.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
x-amz-chime-bearerstringThe ARN of the AppInstanceUser or AppInstanceBot that makes the API call.
app-instance-user-arnstringThe ARN of the user or bot.
max-resultsintegerThe maximum number of users that you want returned.
next-tokenstringThe token returned from previous API requests until the number of channel memberships is reached.

SELECT examples

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.

SELECT
channel_memberships,
next_token
FROM aws.chime_sdk_messaging.channel_memberships_for_app_instance_users
WHERE `x-amz-chime-bearer` = '{{ x-amz-chime-bearer }}' -- required
AND region = '{{ region }}' -- required
AND `app-instance-user-arn` = '{{ app-instance-user-arn }}'
AND `max-results` = '{{ max-results }}'
AND `next-token` = '{{ next-token }}'
;