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 }}'
;