WorkMail / Paginator / ListUsers

ListUsers

class WorkMail.Paginator.ListUsers

paginator = client.get_paginator('list_users')

paginate(**kwargs)

Creates an iterator that will paginate through responses from WorkMail.Client.list_users().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    OrganizationId='string',
    Filters={
        'UsernamePrefix': 'string',
        'DisplayNamePrefix': 'string',
        'PrimaryEmailPrefix': 'string',
        'State': 'ENABLED'|'DISABLED'|'DELETED',
        'IdentityProviderUserIdPrefix': 'string'
    },
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

• OrganizationId (string) –

  [REQUIRED]

  The identifier for the organization under which the users exist.

• Filters (dict) –

  Limit the user search results based on the filter criteria. You can only use one filter per request.

  • UsernamePrefix (string) –

    Filters only users with the provided username prefix.

  • DisplayNamePrefix (string) –

    Filters only users with the provided display name prefix.

  • PrimaryEmailPrefix (string) –

    Filters only users with the provided email prefix.

  • State (string) –

    Filters only users with the provided state.

  • IdentityProviderUserIdPrefix (string) –

    Filters only users with the ID from the IAM Identity Center.

• PaginationConfig (dict) –

  A dictionary that provides parameters to control pagination.

  • MaxItems (integer) –

    The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

  • PageSize (integer) –

    The size of each page.

  • StartingToken (string) –

    A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'Users': [
        {
            'Id': 'string',
            'Email': 'string',
            'Name': 'string',
            'DisplayName': 'string',
            'State': 'ENABLED'|'DISABLED'|'DELETED',
            'UserRole': 'USER'|'RESOURCE'|'SYSTEM_USER'|'REMOTE_USER',
            'EnabledDate': datetime(2015, 1, 1),
            'DisabledDate': datetime(2015, 1, 1),
            'IdentityProviderUserId': 'string',
            'IdentityProviderIdentityStoreId': 'string'
        },
    ],

}

Response Structure

• (dict) –

  • Users (list) –

    The overview of users for an organization.

    • (dict) –

      The representation of an WorkMail user.

      • Id (string) –

        The identifier of the user.

      • Email (string) –

        The email of the user.

      • Name (string) –

        The name of the user.

      • DisplayName (string) –

        The display name of the user.

      • State (string) –

        The state of the user, which can be ENABLED, DISABLED, or DELETED.

      • UserRole (string) –

        The role of the user.

      • EnabledDate (datetime) –

        The date indicating when the user was enabled for WorkMail use.

      • DisabledDate (datetime) –

        The date indicating when the user was disabled from WorkMail use.

      • IdentityProviderUserId (string) –

        User ID from the IAM Identity Center. If this parameter is empty it will be updated automatically when the user logs in for the first time to the mailbox associated with WorkMail.

      • IdentityProviderIdentityStoreId (string) –

        Identity store ID from the IAM Identity Center. If this parameter is empty it will be updated automatically when the user logs in for the first time to the mailbox associated with WorkMail.