Chime

Table of Contents

Client

class Chime.Client

A low-level client representing Amazon Chime:

import boto3

client = boto3.client('chime')

These are the available methods:

batch_suspend_user(**kwargs)

Suspends up to 50 users from a Team or EnterpriseLWA Amazon Chime account. For more information about different account types, see Managing Your Amazon Chime Accounts in the Amazon Chime Administration Guide .

Users suspended from a Team account are dissociated from the account, but they can continue to use Amazon Chime as free users. To remove the suspension from suspended Team account users, invite them to the Team account again. You can use the InviteUsers action to do so.

Users suspended from an EnterpriseLWA account are immediately signed out of Amazon Chime and are no longer able to sign in. To remove the suspension from suspended EnterpriseLWA account users, use the BatchUnsuspendUser action.

To sign out users without suspending them, use the LogoutUser action.

See also: AWS API Documentation

Request Syntax

response = client.batch_suspend_user(
    AccountId='string',
    UserIdList=[
        'string',
    ]
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • UserIdList (list) --

    [REQUIRED]

    The request containing the user IDs to suspend.

    • (string) --
Return type

dict

Returns

Response Syntax

{
    'UserErrors': [
        {
            'UserId': 'string',
            'ErrorCode': 'Unauthorized'|'Forbidden'|'NotFound'|'BadRequest'|'Conflict'|'ServiceFailure'|'ServiceUnavailable'|'Unprocessable'|'Throttled'|'PreconditionFailed',
            'ErrorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • UserErrors (list) --

      If the BatchSuspendUser action fails for one or more of the user IDs in the request, a list of the user IDs is returned, along with error codes and error messages.

      • (dict) --

        The list of errors returned when errors are encountered during the BatchSuspendUser , BatchUnsuspendUser , or BatchUpdateUser actions. This includes user IDs, error codes, and error messages.

        • UserId (string) --

          The user ID for which the action failed.

        • ErrorCode (string) --

          The error code.

        • ErrorMessage (string) --

          The error message.

batch_unsuspend_user(**kwargs)

Removes the suspension from up to 50 previously suspended users for the specified Amazon Chime EnterpriseLWA account. Only users on EnterpriseLWA accounts can be unsuspended using this action. For more information about different account types, see Managing Your Amazon Chime Accounts in the Amazon Chime Administration Guide .

Previously suspended users who are unsuspended using this action are returned to Registered status. Users who are not previously suspended are ignored.

See also: AWS API Documentation

Request Syntax

response = client.batch_unsuspend_user(
    AccountId='string',
    UserIdList=[
        'string',
    ]
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • UserIdList (list) --

    [REQUIRED]

    The request containing the user IDs to unsuspend.

    • (string) --
Return type

dict

Returns

Response Syntax

{
    'UserErrors': [
        {
            'UserId': 'string',
            'ErrorCode': 'Unauthorized'|'Forbidden'|'NotFound'|'BadRequest'|'Conflict'|'ServiceFailure'|'ServiceUnavailable'|'Unprocessable'|'Throttled'|'PreconditionFailed',
            'ErrorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • UserErrors (list) --

      If the BatchUnsuspendUser action fails for one or more of the user IDs in the request, a list of the user IDs is returned, along with error codes and error messages.

      • (dict) --

        The list of errors returned when errors are encountered during the BatchSuspendUser , BatchUnsuspendUser , or BatchUpdateUser actions. This includes user IDs, error codes, and error messages.

        • UserId (string) --

          The user ID for which the action failed.

        • ErrorCode (string) --

          The error code.

        • ErrorMessage (string) --

          The error message.

batch_update_user(**kwargs)

Updates user details within the UpdateUserRequestItem object for up to 20 users for the specified Amazon Chime account. Currently, only LicenseType updates are supported for this action.

See also: AWS API Documentation

Request Syntax

response = client.batch_update_user(
    AccountId='string',
    UpdateUserRequestItems=[
        {
            'UserId': 'string',
            'LicenseType': 'Basic'|'Plus'|'Pro'|'ProTrial'
        },
    ]
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • UpdateUserRequestItems (list) --

    [REQUIRED]

    The request containing the user IDs and details to update.

    • (dict) --

      The user ID and user fields to update, used with the BatchUpdateUser action.

      • UserId (string) -- [REQUIRED]

        The user ID.

      • LicenseType (string) --

        The user license type.

Return type

dict

Returns

Response Syntax

{
    'UserErrors': [
        {
            'UserId': 'string',
            'ErrorCode': 'Unauthorized'|'Forbidden'|'NotFound'|'BadRequest'|'Conflict'|'ServiceFailure'|'ServiceUnavailable'|'Unprocessable'|'Throttled'|'PreconditionFailed',
            'ErrorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • UserErrors (list) --

      If the BatchUpdateUser action fails for one or more of the user IDs in the request, a list of the user IDs is returned, along with error codes and error messages.

      • (dict) --

        The list of errors returned when errors are encountered during the BatchSuspendUser , BatchUnsuspendUser , or BatchUpdateUser actions. This includes user IDs, error codes, and error messages.

        • UserId (string) --

          The user ID for which the action failed.

        • ErrorCode (string) --

          The error code.

        • ErrorMessage (string) --

          The error message.

can_paginate(operation_name)

Check if an operation can be paginated.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Returns
True if the operation can be paginated, False otherwise.
create_account(**kwargs)

Creates an Amazon Chime account under the administrator's AWS account. Only Team account types are currently supported for this action. For more information about different account types, see Managing Your Amazon Chime Accounts in the Amazon Chime Administration Guide .

See also: AWS API Documentation

Request Syntax

response = client.create_account(
    Name='string'
)
Parameters
Name (string) --

[REQUIRED]

The name of the Amazon Chime account.

Return type
dict
Returns
Response Syntax
{
    'Account': {
        'AwsAccountId': 'string',
        'AccountId': 'string',
        'Name': 'string',
        'AccountType': 'Team'|'EnterpriseDirectory'|'EnterpriseLWA'|'EnterpriseOIDC',
        'CreatedTimestamp': datetime(2015, 1, 1),
        'DefaultLicense': 'Basic'|'Plus'|'Pro'|'ProTrial',
        'SupportedLicenses': [
            'Basic'|'Plus'|'Pro'|'ProTrial',
        ]
    }
}

Response Structure

  • (dict) --
    • Account (dict) --

      The Amazon Chime account details.

      • AwsAccountId (string) --

        The AWS account ID.

      • AccountId (string) --

        The Amazon Chime account ID.

      • Name (string) --

        The Amazon Chime account name.

      • AccountType (string) --

        The Amazon Chime account type. For more information about different account types, see Managing Your Amazon Chime Accounts in the Amazon Chime Administration Guide .

      • CreatedTimestamp (datetime) --

        The Amazon Chime account creation timestamp, in ISO 8601 format.

      • DefaultLicense (string) --

        The default license for the Amazon Chime account.

      • SupportedLicenses (list) --

        Supported licenses for the Amazon Chime account.

        • (string) --
delete_account(**kwargs)

Deletes the specified Amazon Chime account. You must suspend all users before deleting a Team account. You can use the BatchSuspendUser action to do so.

For EnterpriseLWA and EnterpriseAD accounts, you must release the claimed domains for your Amazon Chime account before deletion. As soon as you release the domain, all users under that account are suspended.

Deleted accounts appear in your Disabled accounts list for 90 days. To restore a deleted account from your Disabled accounts list, you must contact AWS Support.

After 90 days, deleted accounts are permanently removed from your Disabled accounts list.

See also: AWS API Documentation

Request Syntax

response = client.delete_account(
    AccountId='string'
)
Parameters
AccountId (string) --

[REQUIRED]

The Amazon Chime account ID.

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --
generate_presigned_url(ClientMethod, Params=None, ExpiresIn=3600, HttpMethod=None)

Generate a presigned url given a client, its method, and arguments

Parameters
  • ClientMethod (string) -- The client method to presign for
  • Params (dict) -- The parameters normally passed to ClientMethod.
  • ExpiresIn (int) -- The number of seconds the presigned url is valid for. By default it expires in an hour (3600 seconds)
  • HttpMethod (string) -- The http method to use on the generated url. By default, the http method is whatever is used in the method's model.
Returns

The presigned url

get_account(**kwargs)

Retrieves details for the specified Amazon Chime account, such as account type and supported licenses.

See also: AWS API Documentation

Request Syntax

response = client.get_account(
    AccountId='string'
)
Parameters
AccountId (string) --

[REQUIRED]

The Amazon Chime account ID.

Return type
dict
Returns
Response Syntax
{
    'Account': {
        'AwsAccountId': 'string',
        'AccountId': 'string',
        'Name': 'string',
        'AccountType': 'Team'|'EnterpriseDirectory'|'EnterpriseLWA'|'EnterpriseOIDC',
        'CreatedTimestamp': datetime(2015, 1, 1),
        'DefaultLicense': 'Basic'|'Plus'|'Pro'|'ProTrial',
        'SupportedLicenses': [
            'Basic'|'Plus'|'Pro'|'ProTrial',
        ]
    }
}

Response Structure

  • (dict) --
    • Account (dict) --

      The Amazon Chime account details.

      • AwsAccountId (string) --

        The AWS account ID.

      • AccountId (string) --

        The Amazon Chime account ID.

      • Name (string) --

        The Amazon Chime account name.

      • AccountType (string) --

        The Amazon Chime account type. For more information about different account types, see Managing Your Amazon Chime Accounts in the Amazon Chime Administration Guide .

      • CreatedTimestamp (datetime) --

        The Amazon Chime account creation timestamp, in ISO 8601 format.

      • DefaultLicense (string) --

        The default license for the Amazon Chime account.

      • SupportedLicenses (list) --

        Supported licenses for the Amazon Chime account.

        • (string) --
get_account_settings(**kwargs)

Retrieves account settings for the specified Amazon Chime account ID, such as remote control and dial out settings. For more information about these settings, see Use the Policies Page in the Amazon Chime Administration Guide .

See also: AWS API Documentation

Request Syntax

response = client.get_account_settings(
    AccountId='string'
)
Parameters
AccountId (string) --

[REQUIRED]

The Amazon Chime account ID.

Return type
dict
Returns
Response Syntax
{
    'AccountSettings': {
        'DisableRemoteControl': True|False,
        'EnableDialOut': True|False
    }
}

Response Structure

  • (dict) --
    • AccountSettings (dict) --

      The Amazon Chime account settings.

      • DisableRemoteControl (boolean) --

        Setting that stops or starts remote control of shared screens during meetings.

      • EnableDialOut (boolean) --

        Setting that allows meeting participants to choose the Call me at a phone number option. For more information, see Join a Meeting without the Amazon Chime App .

get_paginator(operation_name)

Create a paginator for an operation.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Raises OperationNotPageableError
Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.
Return type
L{botocore.paginate.Paginator}
Returns
A paginator object.
get_user(**kwargs)

Retrieves details for the specified user ID, such as primary email address, license type, and personal meeting PIN.

To retrieve user details with an email address instead of a user ID, use the ListUsers action, and then filter by email address.

See also: AWS API Documentation

Request Syntax

response = client.get_user(
    AccountId='string',
    UserId='string'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • UserId (string) --

    [REQUIRED]

    The user ID.

Return type

dict

Returns

Response Syntax

{
    'User': {
        'UserId': 'string',
        'AccountId': 'string',
        'PrimaryEmail': 'string',
        'DisplayName': 'string',
        'LicenseType': 'Basic'|'Plus'|'Pro'|'ProTrial',
        'UserRegistrationStatus': 'Unregistered'|'Registered'|'Suspended',
        'UserInvitationStatus': 'Pending'|'Accepted'|'Failed',
        'RegisteredOn': datetime(2015, 1, 1),
        'InvitedOn': datetime(2015, 1, 1),
        'PersonalPIN': 'string'
    }
}

Response Structure

  • (dict) --

    • User (dict) --

      The user details.

      • UserId (string) --

        The user ID.

      • AccountId (string) --

        The Amazon Chime account ID.

      • PrimaryEmail (string) --

        The primary email address of the user.

      • DisplayName (string) --

        The display name of the user.

      • LicenseType (string) --

        The license type for the user.

      • UserRegistrationStatus (string) --

        The user registration status.

      • UserInvitationStatus (string) --

        The user invite status.

      • RegisteredOn (datetime) --

        Date and time when the user is registered, in ISO 8601 format.

      • InvitedOn (datetime) --

        Date and time when the user is invited to the Amazon Chime account, in ISO 8601 format.

      • PersonalPIN (string) --

        The user's personal meeting PIN.

get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters
waiter_name (str) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
Returns
The specified waiter object.
Return type
botocore.waiter.Waiter
invite_users(**kwargs)

Sends email invites to as many as 50 users, inviting them to the specified Amazon Chime Team account. Only Team account types are currently supported for this action.

See also: AWS API Documentation

Request Syntax

response = client.invite_users(
    AccountId='string',
    UserEmailList=[
        'string',
    ]
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • UserEmailList (list) --

    [REQUIRED]

    The user email addresses to which to send the invite.

    • (string) --
Return type

dict

Returns

Response Syntax

{
    'Invites': [
        {
            'InviteId': 'string',
            'Status': 'Pending'|'Accepted'|'Failed',
            'EmailAddress': 'string',
            'EmailStatus': 'NotSent'|'Sent'|'Failed'
        },
    ]
}

Response Structure

  • (dict) --

    • Invites (list) --

      The invite details.

      • (dict) --

        Invitation object returned after emailing users to invite them to join the Amazon Chime Team account.

        • InviteId (string) --

          The invite ID.

        • Status (string) --

          The status of the invite.

        • EmailAddress (string) --

          The email address to which the invite is sent.

        • EmailStatus (string) --

          The status of the invite email.

list_accounts(**kwargs)

Lists the Amazon Chime accounts under the administrator's AWS account. You can filter accounts by account name prefix. To find out which Amazon Chime account a user belongs to, you can filter by the user's email address, which returns one account result.

See also: AWS API Documentation

Request Syntax

response = client.list_accounts(
    Name='string',
    UserEmail='string',
    NextToken='string',
    MaxResults=123
)
Parameters
  • Name (string) -- Amazon Chime account name prefix with which to filter results.
  • UserEmail (string) -- User email address with which to filter results.
  • NextToken (string) -- The token to use to retrieve the next page of results.
  • MaxResults (integer) -- The maximum number of results to return in a single call. Defaults to 100.
Return type

dict

Returns

Response Syntax

{
    'Accounts': [
        {
            'AwsAccountId': 'string',
            'AccountId': 'string',
            'Name': 'string',
            'AccountType': 'Team'|'EnterpriseDirectory'|'EnterpriseLWA'|'EnterpriseOIDC',
            'CreatedTimestamp': datetime(2015, 1, 1),
            'DefaultLicense': 'Basic'|'Plus'|'Pro'|'ProTrial',
            'SupportedLicenses': [
                'Basic'|'Plus'|'Pro'|'ProTrial',
            ]
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Accounts (list) --

      List of Amazon Chime accounts and account details.

      • (dict) --

        The Amazon Chime account details. An AWS account can have multiple Amazon Chime accounts.

        • AwsAccountId (string) --

          The AWS account ID.

        • AccountId (string) --

          The Amazon Chime account ID.

        • Name (string) --

          The Amazon Chime account name.

        • AccountType (string) --

          The Amazon Chime account type. For more information about different account types, see Managing Your Amazon Chime Accounts in the Amazon Chime Administration Guide .

        • CreatedTimestamp (datetime) --

          The Amazon Chime account creation timestamp, in ISO 8601 format.

        • DefaultLicense (string) --

          The default license for the Amazon Chime account.

        • SupportedLicenses (list) --

          Supported licenses for the Amazon Chime account.

          • (string) --
    • NextToken (string) --

      The token to use to retrieve the next page of results.

list_users(**kwargs)

Lists the users that belong to the specified Amazon Chime account. You can specify an email address to list only the user that the email address belongs to.

See also: AWS API Documentation

Request Syntax

response = client.list_users(
    AccountId='string',
    UserEmail='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • UserEmail (string) -- Optional. The user email address used to filter results. Maximum 1.
  • MaxResults (integer) -- The maximum number of results to return in a single call. Defaults to 100.
  • NextToken (string) -- The token to use to retrieve the next page of results.
Return type

dict

Returns

Response Syntax

{
    'Users': [
        {
            'UserId': 'string',
            'AccountId': 'string',
            'PrimaryEmail': 'string',
            'DisplayName': 'string',
            'LicenseType': 'Basic'|'Plus'|'Pro'|'ProTrial',
            'UserRegistrationStatus': 'Unregistered'|'Registered'|'Suspended',
            'UserInvitationStatus': 'Pending'|'Accepted'|'Failed',
            'RegisteredOn': datetime(2015, 1, 1),
            'InvitedOn': datetime(2015, 1, 1),
            'PersonalPIN': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Users (list) --

      List of users and user details.

      • (dict) --

        The user on the Amazon Chime account.

        • UserId (string) --

          The user ID.

        • AccountId (string) --

          The Amazon Chime account ID.

        • PrimaryEmail (string) --

          The primary email address of the user.

        • DisplayName (string) --

          The display name of the user.

        • LicenseType (string) --

          The license type for the user.

        • UserRegistrationStatus (string) --

          The user registration status.

        • UserInvitationStatus (string) --

          The user invite status.

        • RegisteredOn (datetime) --

          Date and time when the user is registered, in ISO 8601 format.

        • InvitedOn (datetime) --

          Date and time when the user is invited to the Amazon Chime account, in ISO 8601 format.

        • PersonalPIN (string) --

          The user's personal meeting PIN.

    • NextToken (string) --

      The token to use to retrieve the next page of results.

logout_user(**kwargs)

Logs out the specified user from all of the devices they are currently logged into.

See also: AWS API Documentation

Request Syntax

response = client.logout_user(
    AccountId='string',
    UserId='string'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • UserId (string) --

    [REQUIRED]

    The user ID.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

reset_personal_pin(**kwargs)

Resets the personal meeting PIN for the specified user on an Amazon Chime account. Returns the User object with the updated personal meeting PIN.

See also: AWS API Documentation

Request Syntax

response = client.reset_personal_pin(
    AccountId='string',
    UserId='string'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • UserId (string) --

    [REQUIRED]

    The user ID.

Return type

dict

Returns

Response Syntax

{
    'User': {
        'UserId': 'string',
        'AccountId': 'string',
        'PrimaryEmail': 'string',
        'DisplayName': 'string',
        'LicenseType': 'Basic'|'Plus'|'Pro'|'ProTrial',
        'UserRegistrationStatus': 'Unregistered'|'Registered'|'Suspended',
        'UserInvitationStatus': 'Pending'|'Accepted'|'Failed',
        'RegisteredOn': datetime(2015, 1, 1),
        'InvitedOn': datetime(2015, 1, 1),
        'PersonalPIN': 'string'
    }
}

Response Structure

  • (dict) --

    • User (dict) --

      The user details and new personal meeting PIN.

      • UserId (string) --

        The user ID.

      • AccountId (string) --

        The Amazon Chime account ID.

      • PrimaryEmail (string) --

        The primary email address of the user.

      • DisplayName (string) --

        The display name of the user.

      • LicenseType (string) --

        The license type for the user.

      • UserRegistrationStatus (string) --

        The user registration status.

      • UserInvitationStatus (string) --

        The user invite status.

      • RegisteredOn (datetime) --

        Date and time when the user is registered, in ISO 8601 format.

      • InvitedOn (datetime) --

        Date and time when the user is invited to the Amazon Chime account, in ISO 8601 format.

      • PersonalPIN (string) --

        The user's personal meeting PIN.

update_account(**kwargs)

Updates account details for the specified Amazon Chime account. Currently, only account name updates are supported for this action.

See also: AWS API Documentation

Request Syntax

response = client.update_account(
    AccountId='string',
    Name='string'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • Name (string) -- The new name for the specified Amazon Chime account.
Return type

dict

Returns

Response Syntax

{
    'Account': {
        'AwsAccountId': 'string',
        'AccountId': 'string',
        'Name': 'string',
        'AccountType': 'Team'|'EnterpriseDirectory'|'EnterpriseLWA'|'EnterpriseOIDC',
        'CreatedTimestamp': datetime(2015, 1, 1),
        'DefaultLicense': 'Basic'|'Plus'|'Pro'|'ProTrial',
        'SupportedLicenses': [
            'Basic'|'Plus'|'Pro'|'ProTrial',
        ]
    }
}

Response Structure

  • (dict) --

    • Account (dict) --

      The updated Amazon Chime account details.

      • AwsAccountId (string) --

        The AWS account ID.

      • AccountId (string) --

        The Amazon Chime account ID.

      • Name (string) --

        The Amazon Chime account name.

      • AccountType (string) --

        The Amazon Chime account type. For more information about different account types, see Managing Your Amazon Chime Accounts in the Amazon Chime Administration Guide .

      • CreatedTimestamp (datetime) --

        The Amazon Chime account creation timestamp, in ISO 8601 format.

      • DefaultLicense (string) --

        The default license for the Amazon Chime account.

      • SupportedLicenses (list) --

        Supported licenses for the Amazon Chime account.

        • (string) --

update_account_settings(**kwargs)

Updates the settings for the specified Amazon Chime account. You can update settings for remote control of shared screens, or for the dial-out option. For more information about these settings, see Use the Policies Page in the Amazon Chime Administration Guide .

See also: AWS API Documentation

Request Syntax

response = client.update_account_settings(
    AccountId='string',
    AccountSettings={
        'DisableRemoteControl': True|False,
        'EnableDialOut': True|False
    }
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • AccountSettings (dict) --

    [REQUIRED]

    The Amazon Chime account settings to update.

    • DisableRemoteControl (boolean) --

      Setting that stops or starts remote control of shared screens during meetings.

    • EnableDialOut (boolean) --

      Setting that allows meeting participants to choose the Call me at a phone number option. For more information, see Join a Meeting without the Amazon Chime App .

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

update_user(**kwargs)

Updates user details for a specified user ID. Currently, only LicenseType updates are supported for this action.

See also: AWS API Documentation

Request Syntax

response = client.update_user(
    AccountId='string',
    UserId='string',
    LicenseType='Basic'|'Plus'|'Pro'|'ProTrial'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • UserId (string) --

    [REQUIRED]

    The user ID.

  • LicenseType (string) -- The user license type to update. This must be a supported license type for the Amazon Chime account that the user belongs to.
Return type

dict

Returns

Response Syntax

{
    'User': {
        'UserId': 'string',
        'AccountId': 'string',
        'PrimaryEmail': 'string',
        'DisplayName': 'string',
        'LicenseType': 'Basic'|'Plus'|'Pro'|'ProTrial',
        'UserRegistrationStatus': 'Unregistered'|'Registered'|'Suspended',
        'UserInvitationStatus': 'Pending'|'Accepted'|'Failed',
        'RegisteredOn': datetime(2015, 1, 1),
        'InvitedOn': datetime(2015, 1, 1),
        'PersonalPIN': 'string'
    }
}

Response Structure

  • (dict) --

    • User (dict) --

      The updated user details.

      • UserId (string) --

        The user ID.

      • AccountId (string) --

        The Amazon Chime account ID.

      • PrimaryEmail (string) --

        The primary email address of the user.

      • DisplayName (string) --

        The display name of the user.

      • LicenseType (string) --

        The license type for the user.

      • UserRegistrationStatus (string) --

        The user registration status.

      • UserInvitationStatus (string) --

        The user invite status.

      • RegisteredOn (datetime) --

        Date and time when the user is registered, in ISO 8601 format.

      • InvitedOn (datetime) --

        Date and time when the user is invited to the Amazon Chime account, in ISO 8601 format.

      • PersonalPIN (string) --

        The user's personal meeting PIN.

Paginators

The available paginators are:

class Chime.Paginator.ListAccounts
paginator = client.get_paginator('list_accounts')
paginate(**kwargs)

Creates an iterator that will paginate through responses from Chime.Client.list_accounts().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Name='string',
    UserEmail='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • Name (string) -- Amazon Chime account name prefix with which to filter results.
  • UserEmail (string) -- User email address with which to filter results.
  • 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

{
    'Accounts': [
        {
            'AwsAccountId': 'string',
            'AccountId': 'string',
            'Name': 'string',
            'AccountType': 'Team'|'EnterpriseDirectory'|'EnterpriseLWA'|'EnterpriseOIDC',
            'CreatedTimestamp': datetime(2015, 1, 1),
            'DefaultLicense': 'Basic'|'Plus'|'Pro'|'ProTrial',
            'SupportedLicenses': [
                'Basic'|'Plus'|'Pro'|'ProTrial',
            ]
        },
    ],

}

Response Structure

  • (dict) --

    • Accounts (list) --

      List of Amazon Chime accounts and account details.

      • (dict) --

        The Amazon Chime account details. An AWS account can have multiple Amazon Chime accounts.

        • AwsAccountId (string) --

          The AWS account ID.

        • AccountId (string) --

          The Amazon Chime account ID.

        • Name (string) --

          The Amazon Chime account name.

        • AccountType (string) --

          The Amazon Chime account type. For more information about different account types, see Managing Your Amazon Chime Accounts in the Amazon Chime Administration Guide .

        • CreatedTimestamp (datetime) --

          The Amazon Chime account creation timestamp, in ISO 8601 format.

        • DefaultLicense (string) --

          The default license for the Amazon Chime account.

        • SupportedLicenses (list) --

          Supported licenses for the Amazon Chime account.

          • (string) --

class Chime.Paginator.ListUsers
paginator = client.get_paginator('list_users')
paginate(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    AccountId='string',
    UserEmail='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • UserEmail (string) -- Optional. The user email address used to filter results. Maximum 1.
  • 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': [
        {
            'UserId': 'string',
            'AccountId': 'string',
            'PrimaryEmail': 'string',
            'DisplayName': 'string',
            'LicenseType': 'Basic'|'Plus'|'Pro'|'ProTrial',
            'UserRegistrationStatus': 'Unregistered'|'Registered'|'Suspended',
            'UserInvitationStatus': 'Pending'|'Accepted'|'Failed',
            'RegisteredOn': datetime(2015, 1, 1),
            'InvitedOn': datetime(2015, 1, 1),
            'PersonalPIN': 'string'
        },
    ],

}

Response Structure

  • (dict) --

    • Users (list) --

      List of users and user details.

      • (dict) --

        The user on the Amazon Chime account.

        • UserId (string) --

          The user ID.

        • AccountId (string) --

          The Amazon Chime account ID.

        • PrimaryEmail (string) --

          The primary email address of the user.

        • DisplayName (string) --

          The display name of the user.

        • LicenseType (string) --

          The license type for the user.

        • UserRegistrationStatus (string) --

          The user registration status.

        • UserInvitationStatus (string) --

          The user invite status.

        • RegisteredOn (datetime) --

          Date and time when the user is registered, in ISO 8601 format.

        • InvitedOn (datetime) --

          Date and time when the user is invited to the Amazon Chime account, in ISO 8601 format.

        • PersonalPIN (string) --

          The user's personal meeting PIN.