Chime / Client / list_channel_memberships

list_channel_memberships#

Chime.Client.list_channel_memberships(**kwargs)#

Lists all channel memberships in a channel.

Note

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.

See also: AWS API Documentation

Request Syntax

response = client.list_channel_memberships(
    ChannelArn='string',
    Type='DEFAULT'|'HIDDEN',
    MaxResults=123,
    NextToken='string',
    ChimeBearer='string'
)
Parameters:

  • ChannelArn (string) –

    [REQUIRED]

    The maximum number of channel memberships that you want returned.

  • Type (string) – The membership type of a user, DEFAULT or HIDDEN . Default members are always returned as part of ListChannelMemberships . Hidden members are only returned if the type filter in ListChannelMemberships equals HIDDEN . Otherwise hidden members are not returned.

  • MaxResults (integer) – The maximum number of channel memberships that you want returned.

  • NextToken (string) – The token passed by previous API calls until all requested channel memberships are returned.

  • ChimeBearer (string) – The AppInstanceUserArn of the user that makes the API call.

Return type:

dict

Returns:

Response Syntax

{
    'ChannelArn': 'string',
    'ChannelMemberships': [
        {
            'Member': {
                'Arn': 'string',
                'Name': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • ChannelArn (string) –

      The ARN of the channel.

    • ChannelMemberships (list) –

      The information for the requested channel memberships.

      • (dict) –

        Summary of the details of a ChannelMembership .

        • Member (dict) –

          A member’s summary data.

          • Arn (string) –

            The ARN in an Identity.

          • Name (string) –

            The name in an Identity.

    • NextToken (string) –

      The token passed by previous API calls until all requested channel memberships are returned.

Exceptions

  • Chime.Client.exceptions.BadRequestException

  • Chime.Client.exceptions.ForbiddenException

  • Chime.Client.exceptions.UnauthorizedClientException

  • Chime.Client.exceptions.ThrottledClientException

  • Chime.Client.exceptions.ServiceUnavailableException

  • Chime.Client.exceptions.ServiceFailureException