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:

associate_phone_number_with_user(**kwargs)

Associates a phone number with the specified Amazon Chime user.

See also: AWS API Documentation

Request Syntax

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

    [REQUIRED]

    The Amazon Chime account ID.

  • UserId (string) --

    [REQUIRED]

    The user ID.

  • E164PhoneNumber (string) --

    [REQUIRED]

    The phone number, in E.164 format.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

associate_phone_numbers_with_voice_connector(**kwargs)

Associates phone numbers with the specified Amazon Chime Voice Connector.

See also: AWS API Documentation

Request Syntax

response = client.associate_phone_numbers_with_voice_connector(
    VoiceConnectorId='string',
    E164PhoneNumbers=[
        'string',
    ],
    ForceAssociate=True|False
)
Parameters
  • VoiceConnectorId (string) --

    [REQUIRED]

    The Amazon Chime Voice Connector ID.

  • E164PhoneNumbers (list) --

    List of phone numbers, in E.164 format.

    • (string) --
  • ForceAssociate (boolean) -- If true, associates the provided phone numbers with the provided Amazon Chime Voice Connector and removes any previously existing associations. If false, does not associate any phone numbers that have previously existing associations.
Return type

dict

Returns

Response Syntax

{
    'PhoneNumberErrors': [
        {
            'PhoneNumberId': 'string',
            'ErrorCode': 'BadRequest'|'Conflict'|'Forbidden'|'NotFound'|'PreconditionFailed'|'ResourceLimitExceeded'|'ServiceFailure'|'AccessDenied'|'ServiceUnavailable'|'Throttled'|'Unauthorized'|'Unprocessable'|'VoiceConnectorGroupAssociationsExist'|'PhoneNumberAssociationsExist',
            'ErrorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • PhoneNumberErrors (list) --

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

      • (dict) --

        If the phone number action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.

        • PhoneNumberId (string) --

          The phone number ID for which the action failed.

        • ErrorCode (string) --

          The error code.

        • ErrorMessage (string) --

          The error message.

associate_phone_numbers_with_voice_connector_group(**kwargs)

Associates phone numbers with the specified Amazon Chime Voice Connector group.

See also: AWS API Documentation

Request Syntax

response = client.associate_phone_numbers_with_voice_connector_group(
    VoiceConnectorGroupId='string',
    E164PhoneNumbers=[
        'string',
    ],
    ForceAssociate=True|False
)
Parameters
  • VoiceConnectorGroupId (string) --

    [REQUIRED]

    The Amazon Chime Voice Connector group ID.

  • E164PhoneNumbers (list) --

    List of phone numbers, in E.164 format.

    • (string) --
  • ForceAssociate (boolean) -- If true, associates the provided phone numbers with the provided Amazon Chime Voice Connector Group and removes any previously existing associations. If false, does not associate any phone numbers that have previously existing associations.
Return type

dict

Returns

Response Syntax

{
    'PhoneNumberErrors': [
        {
            'PhoneNumberId': 'string',
            'ErrorCode': 'BadRequest'|'Conflict'|'Forbidden'|'NotFound'|'PreconditionFailed'|'ResourceLimitExceeded'|'ServiceFailure'|'AccessDenied'|'ServiceUnavailable'|'Throttled'|'Unauthorized'|'Unprocessable'|'VoiceConnectorGroupAssociationsExist'|'PhoneNumberAssociationsExist',
            'ErrorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • PhoneNumberErrors (list) --

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

      • (dict) --

        If the phone number action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.

        • PhoneNumberId (string) --

          The phone number ID for which the action failed.

        • ErrorCode (string) --

          The error code.

        • ErrorMessage (string) --

          The error message.

batch_create_attendee(**kwargs)

Creates up to 100 new attendees for an active Amazon Chime SDK meeting. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide .

See also: AWS API Documentation

Request Syntax

response = client.batch_create_attendee(
    MeetingId='string',
    Attendees=[
        {
            'ExternalUserId': 'string'
        },
    ]
)
Parameters
  • MeetingId (string) --

    [REQUIRED]

    The Amazon Chime SDK meeting ID.

  • Attendees (list) --

    [REQUIRED]

    The request containing the attendees to create.

    • (dict) --

      The Amazon Chime SDK attendee fields to create, used with the BatchCreateAttendee action.

      • ExternalUserId (string) -- [REQUIRED]

        The Amazon Chime SDK external user ID. Links the attendee to an identity managed by a builder application.

Return type

dict

Returns

Response Syntax

{
    'Attendees': [
        {
            'ExternalUserId': 'string',
            'AttendeeId': 'string',
            'JoinToken': 'string'
        },
    ],
    'Errors': [
        {
            'ExternalUserId': 'string',
            'ErrorCode': 'string',
            'ErrorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • Attendees (list) --

      The attendee information, including attendees IDs and join tokens.

      • (dict) --

        An Amazon Chime SDK meeting attendee. Includes a unique AttendeeId and JoinToken . The JoinToken allows a client to authenticate and join as the specified attendee. The JoinToken expires when the meeting ends or when DeleteAttendee is called. After that, the attendee is unable to join the meeting.

        We recommend securely transferring each JoinToken from your server application to the client so that no other client has access to the token except for the one authorized to represent the attendee.

        • ExternalUserId (string) --

          The Amazon Chime SDK external user ID. Links the attendee to an identity managed by a builder application.

        • AttendeeId (string) --

          The Amazon Chime SDK attendee ID.

        • JoinToken (string) --

          The join token used by the Amazon Chime SDK attendee.

    • Errors (list) --

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

      • (dict) --

        The list of errors returned when errors are encountered during the BatchCreateAttendee and CreateAttendee actions. This includes external user IDs, error codes, and error messages.

        • ExternalUserId (string) --

          The Amazon Chime SDK external user ID. Links the attendee to an identity managed by a builder application.

        • ErrorCode (string) --

          The error code.

        • ErrorMessage (string) --

          The error message.

batch_create_room_membership(**kwargs)

Adds up to 50 members to a chat room. Members can be either users or bots. The member role designates whether the member is a chat room administrator or a general chat room member.

See also: AWS API Documentation

Request Syntax

response = client.batch_create_room_membership(
    AccountId='string',
    RoomId='string',
    MembershipItemList=[
        {
            'MemberId': 'string',
            'Role': 'Administrator'|'Member'
        },
    ]
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • RoomId (string) --

    [REQUIRED]

    The room ID.

  • MembershipItemList (list) --

    [REQUIRED]

    The list of membership items.

    • (dict) --

      Membership details, such as member ID and member role.

      • MemberId (string) --

        The member ID.

      • Role (string) --

        The member role.

Return type

dict

Returns

Response Syntax

{
    'Errors': [
        {
            'MemberId': 'string',
            'ErrorCode': 'BadRequest'|'Conflict'|'Forbidden'|'NotFound'|'PreconditionFailed'|'ResourceLimitExceeded'|'ServiceFailure'|'AccessDenied'|'ServiceUnavailable'|'Throttled'|'Unauthorized'|'Unprocessable'|'VoiceConnectorGroupAssociationsExist'|'PhoneNumberAssociationsExist',
            'ErrorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • Errors (list) --

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

      • (dict) --

        The list of errors returned when a member action results in an error.

        • MemberId (string) --

          The member ID.

        • ErrorCode (string) --

          The error code.

        • ErrorMessage (string) --

          The error message.

batch_delete_phone_number(**kwargs)

Moves phone numbers into the Deletion queue . Phone numbers must be disassociated from any users or Amazon Chime Voice Connectors before they can be deleted.

Phone numbers remain in the Deletion queue for 7 days before they are deleted permanently.

See also: AWS API Documentation

Request Syntax

response = client.batch_delete_phone_number(
    PhoneNumberIds=[
        'string',
    ]
)
Parameters
PhoneNumberIds (list) --

[REQUIRED]

List of phone number IDs.

  • (string) --
Return type
dict
Returns
Response Syntax
{
    'PhoneNumberErrors': [
        {
            'PhoneNumberId': 'string',
            'ErrorCode': 'BadRequest'|'Conflict'|'Forbidden'|'NotFound'|'PreconditionFailed'|'ResourceLimitExceeded'|'ServiceFailure'|'AccessDenied'|'ServiceUnavailable'|'Throttled'|'Unauthorized'|'Unprocessable'|'VoiceConnectorGroupAssociationsExist'|'PhoneNumberAssociationsExist',
            'ErrorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --
    • PhoneNumberErrors (list) --

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

      • (dict) --

        If the phone number action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.

        • PhoneNumberId (string) --

          The phone number ID for which the action failed.

        • ErrorCode (string) --

          The error code.

        • ErrorMessage (string) --

          The error message.

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 dissasociated 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 can no longer 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': 'BadRequest'|'Conflict'|'Forbidden'|'NotFound'|'PreconditionFailed'|'ResourceLimitExceeded'|'ServiceFailure'|'AccessDenied'|'ServiceUnavailable'|'Throttled'|'Unauthorized'|'Unprocessable'|'VoiceConnectorGroupAssociationsExist'|'PhoneNumberAssociationsExist',
            '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': 'BadRequest'|'Conflict'|'Forbidden'|'NotFound'|'PreconditionFailed'|'ResourceLimitExceeded'|'ServiceFailure'|'AccessDenied'|'ServiceUnavailable'|'Throttled'|'Unauthorized'|'Unprocessable'|'VoiceConnectorGroupAssociationsExist'|'PhoneNumberAssociationsExist',
            '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_phone_number(**kwargs)

Updates phone number product types or calling names. You can update one attribute at a time for each UpdatePhoneNumberRequestItem . For example, you can update either the product type or the calling name.

For product types, choose from Amazon Chime Business Calling and Amazon Chime Voice Connector. For toll-free numbers, you must use the Amazon Chime Voice Connector product type.

Updates to outbound calling names can take up to 72 hours to complete. Pending updates to outbound calling names must be complete before you can request another update.

See also: AWS API Documentation

Request Syntax

response = client.batch_update_phone_number(
    UpdatePhoneNumberRequestItems=[
        {
            'PhoneNumberId': 'string',
            'ProductType': 'BusinessCalling'|'VoiceConnector',
            'CallingName': 'string'
        },
    ]
)
Parameters
UpdatePhoneNumberRequestItems (list) --

[REQUIRED]

The request containing the phone number IDs and product types or calling names to update.

  • (dict) --

    The phone number ID, product type, or calling name fields to update, used with the BatchUpdatePhoneNumber and UpdatePhoneNumber actions.

    • PhoneNumberId (string) -- [REQUIRED]

      The phone number ID to update.

    • ProductType (string) --

      The product type to update.

    • CallingName (string) --

      The outbound calling name to update.

Return type
dict
Returns
Response Syntax
{
    'PhoneNumberErrors': [
        {
            'PhoneNumberId': 'string',
            'ErrorCode': 'BadRequest'|'Conflict'|'Forbidden'|'NotFound'|'PreconditionFailed'|'ResourceLimitExceeded'|'ServiceFailure'|'AccessDenied'|'ServiceUnavailable'|'Throttled'|'Unauthorized'|'Unprocessable'|'VoiceConnectorGroupAssociationsExist'|'PhoneNumberAssociationsExist',
            'ErrorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --
    • PhoneNumberErrors (list) --

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

      • (dict) --

        If the phone number action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.

        • PhoneNumberId (string) --

          The phone number 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': 'BadRequest'|'Conflict'|'Forbidden'|'NotFound'|'PreconditionFailed'|'ResourceLimitExceeded'|'ServiceFailure'|'AccessDenied'|'ServiceUnavailable'|'Throttled'|'Unauthorized'|'Unprocessable'|'VoiceConnectorGroupAssociationsExist'|'PhoneNumberAssociationsExist',
            '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) --
create_attendee(**kwargs)

Creates a new attendee for an active Amazon Chime SDK meeting. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide .

See also: AWS API Documentation

Request Syntax

response = client.create_attendee(
    MeetingId='string',
    ExternalUserId='string'
)
Parameters
  • MeetingId (string) --

    [REQUIRED]

    The Amazon Chime SDK meeting ID.

  • ExternalUserId (string) --

    [REQUIRED]

    The Amazon Chime SDK external user ID. Links the attendee to an identity managed by a builder application.

Return type

dict

Returns

Response Syntax

{
    'Attendee': {
        'ExternalUserId': 'string',
        'AttendeeId': 'string',
        'JoinToken': 'string'
    }
}

Response Structure

  • (dict) --

    • Attendee (dict) --

      The attendee information, including attendee ID and join token.

      • ExternalUserId (string) --

        The Amazon Chime SDK external user ID. Links the attendee to an identity managed by a builder application.

      • AttendeeId (string) --

        The Amazon Chime SDK attendee ID.

      • JoinToken (string) --

        The join token used by the Amazon Chime SDK attendee.

create_bot(**kwargs)

Creates a bot for an Amazon Chime Enterprise account.

See also: AWS API Documentation

Request Syntax

response = client.create_bot(
    AccountId='string',
    DisplayName='string',
    Domain='string'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • DisplayName (string) --

    [REQUIRED]

    The bot display name.

  • Domain (string) -- The domain of the Amazon Chime Enterprise account.
Return type

dict

Returns

Response Syntax

{
    'Bot': {
        'BotId': 'string',
        'UserId': 'string',
        'DisplayName': 'string',
        'BotType': 'ChatBot',
        'Disabled': True|False,
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1),
        'BotEmail': 'string',
        'SecurityToken': 'string'
    }
}

Response Structure

  • (dict) --

    • Bot (dict) --

      The bot details.

      • BotId (string) --

        The bot ID.

      • UserId (string) --

        The unique ID for the bot user.

      • DisplayName (string) --

        The bot display name.

      • BotType (string) --

        The bot type.

      • Disabled (boolean) --

        When true, the bot is stopped from running in your account.

      • CreatedTimestamp (datetime) --

        The bot creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated bot timestamp, in ISO 8601 format.

      • BotEmail (string) --

        The bot email address.

      • SecurityToken (string) --

        The security token used to authenticate Amazon Chime with the outgoing event endpoint.

create_meeting(**kwargs)

Creates a new Amazon Chime SDK meeting in the specified media Region with no initial attendees. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide .

See also: AWS API Documentation

Request Syntax

response = client.create_meeting(
    ClientRequestToken='string',
    MeetingHostId='string',
    MediaRegion='string',
    NotificationsConfiguration={
        'SnsTopicArn': 'string',
        'SqsQueueArn': 'string'
    }
)
Parameters
  • ClientRequestToken (string) --

    [REQUIRED]

    The unique identifier for the client request. Use a different token for different meetings.

    This field is autopopulated if not provided.

  • MeetingHostId (string) -- Reserved.
  • MediaRegion (string) -- The Region in which to create the meeting. Available values: us-east-1 , us-west-2 .
  • NotificationsConfiguration (dict) --

    The configuration for resource targets to receive notifications when meeting and attendee events occur.

    • SnsTopicArn (string) --

      The SNS topic ARN.

    • SqsQueueArn (string) --

      The SQS queue ARN.

Return type

dict

Returns

Response Syntax

{
    'Meeting': {
        'MeetingId': 'string',
        'MediaPlacement': {
            'AudioHostUrl': 'string',
            'ScreenDataUrl': 'string',
            'ScreenSharingUrl': 'string',
            'ScreenViewingUrl': 'string',
            'SignalingUrl': 'string',
            'TurnControlUrl': 'string'
        },
        'MediaRegion': 'string'
    }
}

Response Structure

  • (dict) --

    • Meeting (dict) --

      The meeting information, including the meeting ID and MediaPlacement .

      • MeetingId (string) --

        The Amazon Chime SDK meeting ID.

      • MediaPlacement (dict) --

        The media placement for the meeting.

        • AudioHostUrl (string) --

          The audio host URL.

        • ScreenDataUrl (string) --

          The screen data URL.

        • ScreenSharingUrl (string) --

          The screen sharing URL.

        • ScreenViewingUrl (string) --

          The screen viewing URL.

        • SignalingUrl (string) --

          The signaling URL.

        • TurnControlUrl (string) --

          The turn control URL.

      • MediaRegion (string) --

        The Region in which to create the meeting. Available values: us-east-1 , us-west-2 .

create_phone_number_order(**kwargs)

Creates an order for phone numbers to be provisioned. Choose from Amazon Chime Business Calling and Amazon Chime Voice Connector product types. For toll-free numbers, you must use the Amazon Chime Voice Connector product type.

See also: AWS API Documentation

Request Syntax

response = client.create_phone_number_order(
    ProductType='BusinessCalling'|'VoiceConnector',
    E164PhoneNumbers=[
        'string',
    ]
)
Parameters
  • ProductType (string) --

    [REQUIRED]

    The phone number product type.

  • E164PhoneNumbers (list) --

    [REQUIRED]

    List of phone numbers, in E.164 format.

    • (string) --
Return type

dict

Returns

Response Syntax

{
    'PhoneNumberOrder': {
        'PhoneNumberOrderId': 'string',
        'ProductType': 'BusinessCalling'|'VoiceConnector',
        'Status': 'Processing'|'Successful'|'Failed'|'Partial',
        'OrderedPhoneNumbers': [
            {
                'E164PhoneNumber': 'string',
                'Status': 'Processing'|'Acquired'|'Failed'
            },
        ],
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    • PhoneNumberOrder (dict) --

      The phone number order details.

      • PhoneNumberOrderId (string) --

        The phone number order ID.

      • ProductType (string) --

        The phone number order product type.

      • Status (string) --

        The status of the phone number order.

      • OrderedPhoneNumbers (list) --

        The ordered phone number details, such as the phone number in E.164 format and the phone number status.

        • (dict) --

          A phone number for which an order has been placed.

          • E164PhoneNumber (string) --

            The phone number, in E.164 format.

          • Status (string) --

            The phone number status.

      • CreatedTimestamp (datetime) --

        The phone number order creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated phone number order timestamp, in ISO 8601 format.

create_room(**kwargs)

Creates a chat room for the specified Amazon Chime account.

See also: AWS API Documentation

Request Syntax

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

    [REQUIRED]

    The Amazon Chime account ID.

  • Name (string) --

    [REQUIRED]

    The room name.

  • ClientRequestToken (string) --

    The idempotency token for the request.

    This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{
    'Room': {
        'RoomId': 'string',
        'Name': 'string',
        'AccountId': 'string',
        'CreatedBy': 'string',
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    • Room (dict) --

      The room details.

      • RoomId (string) --

        The room ID.

      • Name (string) --

        The room name.

      • AccountId (string) --

        The Amazon Chime account ID.

      • CreatedBy (string) --

        The identifier of the room creator.

      • CreatedTimestamp (datetime) --

        The room creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The room update timestamp, in ISO 8601 format.

create_room_membership(**kwargs)

Adds a member to a chat room. A member can be either a user or a bot. The member role designates whether the member is a chat room administrator or a general chat room member.

See also: AWS API Documentation

Request Syntax

response = client.create_room_membership(
    AccountId='string',
    RoomId='string',
    MemberId='string',
    Role='Administrator'|'Member'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • RoomId (string) --

    [REQUIRED]

    The room ID.

  • MemberId (string) --

    [REQUIRED]

    The Amazon Chime member ID (user ID or bot ID).

  • Role (string) -- The role of the member.
Return type

dict

Returns

Response Syntax

{
    'RoomMembership': {
        'RoomId': 'string',
        'Member': {
            'MemberId': 'string',
            'MemberType': 'User'|'Bot'|'Webhook',
            'Email': 'string',
            'FullName': 'string',
            'AccountId': 'string'
        },
        'Role': 'Administrator'|'Member',
        'InvitedBy': 'string',
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    • RoomMembership (dict) --

      The room membership details.

      • RoomId (string) --

        The room ID.

      • Member (dict) --

        The member details, such as email address, name, member ID, and member type.

        • MemberId (string) --

          The member ID (user ID or bot ID).

        • MemberType (string) --

          The member type.

        • Email (string) --

          The member email address.

        • FullName (string) --

          The member name.

        • AccountId (string) --

          The Amazon Chime account ID.

      • Role (string) --

        The membership role.

      • InvitedBy (string) --

        The identifier of the user that invited the room member.

      • UpdatedTimestamp (datetime) --

        The room membership update timestamp, in ISO 8601 format.

create_voice_connector(**kwargs)

Creates an Amazon Chime Voice Connector under the administrator's AWS account. You can choose to create an Amazon Chime Voice Connector in a specific AWS Region.

Enabling CreateVoiceConnectorRequest$RequireEncryption configures your Amazon Chime Voice Connector to use TLS transport for SIP signaling and Secure RTP (SRTP) for media. Inbound calls use TLS transport, and unencrypted outbound calls are blocked.

See also: AWS API Documentation

Request Syntax

response = client.create_voice_connector(
    Name='string',
    AwsRegion='us-east-1'|'us-west-2',
    RequireEncryption=True|False
)
Parameters
  • Name (string) --

    [REQUIRED]

    The name of the Amazon Chime Voice Connector.

  • AwsRegion (string) -- The AWS Region in which the Amazon Chime Voice Connector is created. Default value: us-east-1 .
  • RequireEncryption (boolean) --

    [REQUIRED]

    When enabled, requires encryption for the Amazon Chime Voice Connector.

Return type

dict

Returns

Response Syntax

{
    'VoiceConnector': {
        'VoiceConnectorId': 'string',
        'AwsRegion': 'us-east-1'|'us-west-2',
        'Name': 'string',
        'OutboundHostName': 'string',
        'RequireEncryption': True|False,
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    • VoiceConnector (dict) --

      The Amazon Chime Voice Connector details.

      • VoiceConnectorId (string) --

        The Amazon Chime Voice Connector ID.

      • AwsRegion (string) --

        The AWS Region in which the Amazon Chime Voice Connector is created. Default: us-east-1 .

      • Name (string) --

        The name of the Amazon Chime Voice Connector.

      • OutboundHostName (string) --

        The outbound host name for the Amazon Chime Voice Connector.

      • RequireEncryption (boolean) --

        Designates whether encryption is required for the Amazon Chime Voice Connector.

      • CreatedTimestamp (datetime) --

        The Amazon Chime Voice Connector creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated Amazon Chime Voice Connector timestamp, in ISO 8601 format.

create_voice_connector_group(**kwargs)

Creates an Amazon Chime Voice Connector group under the administrator's AWS account. You can associate up to three existing Amazon Chime Voice Connectors with the Amazon Chime Voice Connector group by including VoiceConnectorItems in the request.

You can include Amazon Chime Voice Connectors from different AWS Regions in your group. This creates a fault tolerant mechanism for fallback in case of availability events.

See also: AWS API Documentation

Request Syntax

response = client.create_voice_connector_group(
    Name='string',
    VoiceConnectorItems=[
        {
            'VoiceConnectorId': 'string',
            'Priority': 123
        },
    ]
)
Parameters
  • Name (string) --

    [REQUIRED]

    The name of the Amazon Chime Voice Connector group.

  • VoiceConnectorItems (list) --

    The Amazon Chime Voice Connectors to route inbound calls to.

    • (dict) --

      For Amazon Chime Voice Connector groups, the Amazon Chime Voice Connectors to which to route inbound calls. Includes priority configuration settings. Limit: 3 VoiceConnectorItems per Amazon Chime Voice Connector group.

      • VoiceConnectorId (string) -- [REQUIRED]

        The Amazon Chime Voice Connector ID.

      • Priority (integer) -- [REQUIRED]

        The priority associated with the Amazon Chime Voice Connector, with 1 being the highest priority. Higher priority Amazon Chime Voice Connectors are attempted first.

Return type

dict

Returns

Response Syntax

{
    'VoiceConnectorGroup': {
        'VoiceConnectorGroupId': 'string',
        'Name': 'string',
        'VoiceConnectorItems': [
            {
                'VoiceConnectorId': 'string',
                'Priority': 123
            },
        ],
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    • VoiceConnectorGroup (dict) --

      The Amazon Chime Voice Connector group details.

      • VoiceConnectorGroupId (string) --

        The Amazon Chime Voice Connector group ID.

      • Name (string) --

        The name of the Amazon Chime Voice Connector group.

      • VoiceConnectorItems (list) --

        The Amazon Chime Voice Connectors to which to route inbound calls.

        • (dict) --

          For Amazon Chime Voice Connector groups, the Amazon Chime Voice Connectors to which to route inbound calls. Includes priority configuration settings. Limit: 3 VoiceConnectorItems per Amazon Chime Voice Connector group.

          • VoiceConnectorId (string) --

            The Amazon Chime Voice Connector ID.

          • Priority (integer) --

            The priority associated with the Amazon Chime Voice Connector, with 1 being the highest priority. Higher priority Amazon Chime Voice Connectors are attempted first.

      • CreatedTimestamp (datetime) --

        The Amazon Chime Voice Connector group creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated Amazon Chime Voice Connector group timestamp, in ISO 8601 format.

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) --
delete_attendee(**kwargs)

Deletes an attendee from the specified Amazon Chime SDK meeting and deletes their JoinToken . Attendees are automatically deleted when a Amazon Chime SDK meeting is deleted. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide .

See also: AWS API Documentation

Request Syntax

response = client.delete_attendee(
    MeetingId='string',
    AttendeeId='string'
)
Parameters
  • MeetingId (string) --

    [REQUIRED]

    The Amazon Chime SDK meeting ID.

  • AttendeeId (string) --

    [REQUIRED]

    The Amazon Chime SDK attendee ID.

Returns

None

delete_events_configuration(**kwargs)

Deletes the events configuration that allows a bot to receive outgoing events.

See also: AWS API Documentation

Request Syntax

response = client.delete_events_configuration(
    AccountId='string',
    BotId='string'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • BotId (string) --

    [REQUIRED]

    The bot ID.

Returns

None

delete_meeting(**kwargs)

Deletes the specified Amazon Chime SDK meeting. When a meeting is deleted, its attendees are also deleted and clients can no longer join it. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide .

See also: AWS API Documentation

Request Syntax

response = client.delete_meeting(
    MeetingId='string'
)
Parameters
MeetingId (string) --

[REQUIRED]

The Amazon Chime SDK meeting ID.

Returns
None
delete_phone_number(**kwargs)

Moves the specified phone number into the Deletion queue . A phone number must be disassociated from any users or Amazon Chime Voice Connectors before it can be deleted.

Deleted phone numbers remain in the Deletion queue for 7 days before they are deleted permanently.

See also: AWS API Documentation

Request Syntax

response = client.delete_phone_number(
    PhoneNumberId='string'
)
Parameters
PhoneNumberId (string) --

[REQUIRED]

The phone number ID.

Returns
None
delete_room(**kwargs)

Deletes a chat room.

See also: AWS API Documentation

Request Syntax

response = client.delete_room(
    AccountId='string',
    RoomId='string'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • RoomId (string) --

    [REQUIRED]

    The chat room ID.

Returns

None

delete_room_membership(**kwargs)

Removes a member from a chat room.

See also: AWS API Documentation

Request Syntax

response = client.delete_room_membership(
    AccountId='string',
    RoomId='string',
    MemberId='string'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • RoomId (string) --

    [REQUIRED]

    The room ID.

  • MemberId (string) --

    [REQUIRED]

    The member ID (user ID or bot ID).

Returns

None

delete_voice_connector(**kwargs)

Deletes the specified Amazon Chime Voice Connector. Any phone numbers associated with the Amazon Chime Voice Connector must be disassociated from it before it can be deleted.

See also: AWS API Documentation

Request Syntax

response = client.delete_voice_connector(
    VoiceConnectorId='string'
)
Parameters
VoiceConnectorId (string) --

[REQUIRED]

The Amazon Chime Voice Connector ID.

Returns
None
delete_voice_connector_group(**kwargs)

Deletes the specified Amazon Chime Voice Connector group. Any VoiceConnectorItems and phone numbers associated with the group must be removed before it can be deleted.

See also: AWS API Documentation

Request Syntax

response = client.delete_voice_connector_group(
    VoiceConnectorGroupId='string'
)
Parameters
VoiceConnectorGroupId (string) --

[REQUIRED]

The Amazon Chime Voice Connector group ID.

Returns
None
delete_voice_connector_origination(**kwargs)

Deletes the origination settings for the specified Amazon Chime Voice Connector.

See also: AWS API Documentation

Request Syntax

response = client.delete_voice_connector_origination(
    VoiceConnectorId='string'
)
Parameters
VoiceConnectorId (string) --

[REQUIRED]

The Amazon Chime Voice Connector ID.

Returns
None
delete_voice_connector_streaming_configuration(**kwargs)

Deletes the streaming configuration for the specified Amazon Chime Voice Connector.

See also: AWS API Documentation

Request Syntax

response = client.delete_voice_connector_streaming_configuration(
    VoiceConnectorId='string'
)
Parameters
VoiceConnectorId (string) --

[REQUIRED]

The Amazon Chime Voice Connector ID.

Returns
None
delete_voice_connector_termination(**kwargs)

Deletes the termination settings for the specified Amazon Chime Voice Connector.

See also: AWS API Documentation

Request Syntax

response = client.delete_voice_connector_termination(
    VoiceConnectorId='string'
)
Parameters
VoiceConnectorId (string) --

[REQUIRED]

The Amazon Chime Voice Connector ID.

Returns
None
delete_voice_connector_termination_credentials(**kwargs)

Deletes the specified SIP credentials used by your equipment to authenticate during call termination.

See also: AWS API Documentation

Request Syntax

response = client.delete_voice_connector_termination_credentials(
    VoiceConnectorId='string',
    Usernames=[
        'string',
    ]
)
Parameters
  • VoiceConnectorId (string) --

    [REQUIRED]

    The Amazon Chime Voice Connector ID.

  • Usernames (list) --

    The RFC2617 compliant username associated with the SIP credentials, in US-ASCII format.

    • (string) --
Returns

None

disassociate_phone_number_from_user(**kwargs)

Disassociates the primary provisioned phone number from the specified Amazon Chime user.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_phone_number_from_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) --

disassociate_phone_numbers_from_voice_connector(**kwargs)

Disassociates the specified phone numbers from the specified Amazon Chime Voice Connector.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_phone_numbers_from_voice_connector(
    VoiceConnectorId='string',
    E164PhoneNumbers=[
        'string',
    ]
)
Parameters
  • VoiceConnectorId (string) --

    [REQUIRED]

    The Amazon Chime Voice Connector ID.

  • E164PhoneNumbers (list) --

    List of phone numbers, in E.164 format.

    • (string) --
Return type

dict

Returns

Response Syntax

{
    'PhoneNumberErrors': [
        {
            'PhoneNumberId': 'string',
            'ErrorCode': 'BadRequest'|'Conflict'|'Forbidden'|'NotFound'|'PreconditionFailed'|'ResourceLimitExceeded'|'ServiceFailure'|'AccessDenied'|'ServiceUnavailable'|'Throttled'|'Unauthorized'|'Unprocessable'|'VoiceConnectorGroupAssociationsExist'|'PhoneNumberAssociationsExist',
            'ErrorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • PhoneNumberErrors (list) --

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

      • (dict) --

        If the phone number action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.

        • PhoneNumberId (string) --

          The phone number ID for which the action failed.

        • ErrorCode (string) --

          The error code.

        • ErrorMessage (string) --

          The error message.

disassociate_phone_numbers_from_voice_connector_group(**kwargs)

Disassociates the specified phone numbers from the specified Amazon Chime Voice Connector group.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_phone_numbers_from_voice_connector_group(
    VoiceConnectorGroupId='string',
    E164PhoneNumbers=[
        'string',
    ]
)
Parameters
  • VoiceConnectorGroupId (string) --

    [REQUIRED]

    The Amazon Chime Voice Connector group ID.

  • E164PhoneNumbers (list) --

    List of phone numbers, in E.164 format.

    • (string) --
Return type

dict

Returns

Response Syntax

{
    'PhoneNumberErrors': [
        {
            'PhoneNumberId': 'string',
            'ErrorCode': 'BadRequest'|'Conflict'|'Forbidden'|'NotFound'|'PreconditionFailed'|'ResourceLimitExceeded'|'ServiceFailure'|'AccessDenied'|'ServiceUnavailable'|'Throttled'|'Unauthorized'|'Unprocessable'|'VoiceConnectorGroupAssociationsExist'|'PhoneNumberAssociationsExist',
            'ErrorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • PhoneNumberErrors (list) --

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

      • (dict) --

        If the phone number action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.

        • PhoneNumberId (string) --

          The phone number ID for which the action failed.

        • ErrorCode (string) --

          The error code.

        • ErrorMessage (string) --

          The error message.

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_attendee(**kwargs)

Gets the Amazon Chime SDK attendee details for a specified meeting ID and attendee ID. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide .

See also: AWS API Documentation

Request Syntax

response = client.get_attendee(
    MeetingId='string',
    AttendeeId='string'
)
Parameters
  • MeetingId (string) --

    [REQUIRED]

    The Amazon Chime SDK meeting ID.

  • AttendeeId (string) --

    [REQUIRED]

    The Amazon Chime SDK attendee ID.

Return type

dict

Returns

Response Syntax

{
    'Attendee': {
        'ExternalUserId': 'string',
        'AttendeeId': 'string',
        'JoinToken': 'string'
    }
}

Response Structure

  • (dict) --

    • Attendee (dict) --

      The Amazon Chime SDK attendee information.

      • ExternalUserId (string) --

        The Amazon Chime SDK external user ID. Links the attendee to an identity managed by a builder application.

      • AttendeeId (string) --

        The Amazon Chime SDK attendee ID.

      • JoinToken (string) --

        The join token used by the Amazon Chime SDK attendee.

get_bot(**kwargs)

Retrieves details for the specified bot, such as bot email address, bot type, status, and display name.

See also: AWS API Documentation

Request Syntax

response = client.get_bot(
    AccountId='string',
    BotId='string'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • BotId (string) --

    [REQUIRED]

    The bot ID.

Return type

dict

Returns

Response Syntax

{
    'Bot': {
        'BotId': 'string',
        'UserId': 'string',
        'DisplayName': 'string',
        'BotType': 'ChatBot',
        'Disabled': True|False,
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1),
        'BotEmail': 'string',
        'SecurityToken': 'string'
    }
}

Response Structure

  • (dict) --

    • Bot (dict) --

      The chat bot details.

      • BotId (string) --

        The bot ID.

      • UserId (string) --

        The unique ID for the bot user.

      • DisplayName (string) --

        The bot display name.

      • BotType (string) --

        The bot type.

      • Disabled (boolean) --

        When true, the bot is stopped from running in your account.

      • CreatedTimestamp (datetime) --

        The bot creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated bot timestamp, in ISO 8601 format.

      • BotEmail (string) --

        The bot email address.

      • SecurityToken (string) --

        The security token used to authenticate Amazon Chime with the outgoing event endpoint.

get_events_configuration(**kwargs)

Gets details for an events configuration that allows a bot to receive outgoing events, such as an HTTPS endpoint or Lambda function ARN.

See also: AWS API Documentation

Request Syntax

response = client.get_events_configuration(
    AccountId='string',
    BotId='string'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • BotId (string) --

    [REQUIRED]

    The bot ID.

Return type

dict

Returns

Response Syntax

{
    'EventsConfiguration': {
        'BotId': 'string',
        'OutboundEventsHTTPSEndpoint': 'string',
        'LambdaFunctionArn': 'string'
    }
}

Response Structure

  • (dict) --

    • EventsConfiguration (dict) --

      The events configuration details.

      • BotId (string) --

        The bot ID.

      • OutboundEventsHTTPSEndpoint (string) --

        HTTPS endpoint that allows a bot to receive outgoing events.

      • LambdaFunctionArn (string) --

        Lambda function ARN that allows a bot to receive outgoing events.

get_global_settings()

Retrieves global settings for the administrator's AWS account, such as Amazon Chime Business Calling and Amazon Chime Voice Connector settings.

See also: AWS API Documentation

Request Syntax

response = client.get_global_settings()
Return type
dict
Returns
Response Syntax
{
    'BusinessCalling': {
        'CdrBucket': 'string'
    },
    'VoiceConnector': {
        'CdrBucket': 'string'
    }
}

Response Structure

  • (dict) --
    • BusinessCalling (dict) --

      The Amazon Chime Business Calling settings.

      • CdrBucket (string) --

        The Amazon S3 bucket designated for call detail record storage.

    • VoiceConnector (dict) --

      The Amazon Chime Voice Connector settings.

      • CdrBucket (string) --

        The Amazon S3 bucket designated for call detail record storage.

get_meeting(**kwargs)

Gets the Amazon Chime SDK meeting details for the specified meeting ID. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide .

See also: AWS API Documentation

Request Syntax

response = client.get_meeting(
    MeetingId='string'
)
Parameters
MeetingId (string) --

[REQUIRED]

The Amazon Chime SDK meeting ID.

Return type
dict
Returns
Response Syntax
{
    'Meeting': {
        'MeetingId': 'string',
        'MediaPlacement': {
            'AudioHostUrl': 'string',
            'ScreenDataUrl': 'string',
            'ScreenSharingUrl': 'string',
            'ScreenViewingUrl': 'string',
            'SignalingUrl': 'string',
            'TurnControlUrl': 'string'
        },
        'MediaRegion': 'string'
    }
}

Response Structure

  • (dict) --
    • Meeting (dict) --

      The Amazon Chime SDK meeting information.

      • MeetingId (string) --

        The Amazon Chime SDK meeting ID.

      • MediaPlacement (dict) --

        The media placement for the meeting.

        • AudioHostUrl (string) --

          The audio host URL.

        • ScreenDataUrl (string) --

          The screen data URL.

        • ScreenSharingUrl (string) --

          The screen sharing URL.

        • ScreenViewingUrl (string) --

          The screen viewing URL.

        • SignalingUrl (string) --

          The signaling URL.

        • TurnControlUrl (string) --

          The turn control URL.

      • MediaRegion (string) --

        The Region in which to create the meeting. Available values: us-east-1 , us-west-2 .

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_phone_number(**kwargs)

Retrieves details for the specified phone number ID, such as associations, capabilities, and product type.

See also: AWS API Documentation

Request Syntax

response = client.get_phone_number(
    PhoneNumberId='string'
)
Parameters
PhoneNumberId (string) --

[REQUIRED]

The phone number ID.

Return type
dict
Returns
Response Syntax
{
    'PhoneNumber': {
        'PhoneNumberId': 'string',
        'E164PhoneNumber': 'string',
        'Type': 'Local'|'TollFree',
        'ProductType': 'BusinessCalling'|'VoiceConnector',
        'Status': 'AcquireInProgress'|'AcquireFailed'|'Unassigned'|'Assigned'|'ReleaseInProgress'|'DeleteInProgress'|'ReleaseFailed'|'DeleteFailed',
        'Capabilities': {
            'InboundCall': True|False,
            'OutboundCall': True|False,
            'InboundSMS': True|False,
            'OutboundSMS': True|False,
            'InboundMMS': True|False,
            'OutboundMMS': True|False
        },
        'Associations': [
            {
                'Value': 'string',
                'Name': 'AccountId'|'UserId'|'VoiceConnectorId'|'VoiceConnectorGroupId',
                'AssociatedTimestamp': datetime(2015, 1, 1)
            },
        ],
        'CallingName': 'string',
        'CallingNameStatus': 'Unassigned'|'UpdateInProgress'|'UpdateSucceeded'|'UpdateFailed',
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1),
        'DeletionTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --
    • PhoneNumber (dict) --

      The phone number details.

      • PhoneNumberId (string) --

        The phone number ID.

      • E164PhoneNumber (string) --

        The phone number, in E.164 format.

      • Type (string) --

        The phone number type.

      • ProductType (string) --

        The phone number product type.

      • Status (string) --

        The phone number status.

      • Capabilities (dict) --

        The phone number capabilities.

        • InboundCall (boolean) --

          Allows or denies inbound calling for the specified phone number.

        • OutboundCall (boolean) --

          Allows or denies outbound calling for the specified phone number.

        • InboundSMS (boolean) --

          Allows or denies inbound SMS messaging for the specified phone number.

        • OutboundSMS (boolean) --

          Allows or denies outbound SMS messaging for the specified phone number.

        • InboundMMS (boolean) --

          Allows or denies inbound MMS messaging for the specified phone number.

        • OutboundMMS (boolean) --

          Allows or denies outbound MMS messaging for the specified phone number.

      • Associations (list) --

        The phone number associations.

        • (dict) --

          The phone number associations, such as Amazon Chime account ID, Amazon Chime user ID, Amazon Chime Voice Connector ID, or Amazon Chime Voice Connector group ID.

          • Value (string) --

            Contains the ID for the entity specified in Name.

          • Name (string) --

            Defines the association with an Amazon Chime account ID, user ID, Amazon Chime Voice Connector ID, or Amazon Chime Voice Connector group ID.

          • AssociatedTimestamp (datetime) --

            The timestamp of the phone number association, in ISO 8601 format.

      • CallingName (string) --

        The outbound calling name associated with the phone number.

      • CallingNameStatus (string) --

        The outbound calling name status.

      • CreatedTimestamp (datetime) --

        The phone number creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated phone number timestamp, in ISO 8601 format.

      • DeletionTimestamp (datetime) --

        The deleted phone number timestamp, in ISO 8601 format.

get_phone_number_order(**kwargs)

Retrieves details for the specified phone number order, such as order creation timestamp, phone numbers in E.164 format, product type, and order status.

See also: AWS API Documentation

Request Syntax

response = client.get_phone_number_order(
    PhoneNumberOrderId='string'
)
Parameters
PhoneNumberOrderId (string) --

[REQUIRED]

The ID for the phone number order.

Return type
dict
Returns
Response Syntax
{
    'PhoneNumberOrder': {
        'PhoneNumberOrderId': 'string',
        'ProductType': 'BusinessCalling'|'VoiceConnector',
        'Status': 'Processing'|'Successful'|'Failed'|'Partial',
        'OrderedPhoneNumbers': [
            {
                'E164PhoneNumber': 'string',
                'Status': 'Processing'|'Acquired'|'Failed'
            },
        ],
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --
    • PhoneNumberOrder (dict) --

      The phone number order details.

      • PhoneNumberOrderId (string) --

        The phone number order ID.

      • ProductType (string) --

        The phone number order product type.

      • Status (string) --

        The status of the phone number order.

      • OrderedPhoneNumbers (list) --

        The ordered phone number details, such as the phone number in E.164 format and the phone number status.

        • (dict) --

          A phone number for which an order has been placed.

          • E164PhoneNumber (string) --

            The phone number, in E.164 format.

          • Status (string) --

            The phone number status.

      • CreatedTimestamp (datetime) --

        The phone number order creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated phone number order timestamp, in ISO 8601 format.

get_phone_number_settings()

Retrieves the phone number settings for the administrator's AWS account, such as the default outbound calling name.

See also: AWS API Documentation

Request Syntax

response = client.get_phone_number_settings()
Return type
dict
Returns
Response Syntax
{
    'CallingName': 'string',
    'CallingNameUpdatedTimestamp': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --
    • CallingName (string) --

      The default outbound calling name for the account.

    • CallingNameUpdatedTimestamp (datetime) --

      The updated outbound calling name timestamp, in ISO 8601 format.

get_room(**kwargs)

Retrieves room details, such as name.

See also: AWS API Documentation

Request Syntax

response = client.get_room(
    AccountId='string',
    RoomId='string'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • RoomId (string) --

    [REQUIRED]

    The room ID.

Return type

dict

Returns

Response Syntax

{
    'Room': {
        'RoomId': 'string',
        'Name': 'string',
        'AccountId': 'string',
        'CreatedBy': 'string',
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    • Room (dict) --

      The room details.

      • RoomId (string) --

        The room ID.

      • Name (string) --

        The room name.

      • AccountId (string) --

        The Amazon Chime account ID.

      • CreatedBy (string) --

        The identifier of the room creator.

      • CreatedTimestamp (datetime) --

        The room creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The room update timestamp, in ISO 8601 format.

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',
        'PrimaryProvisionedNumber': '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.

      • PrimaryProvisionedNumber (string) --

        The primary phone number associated with 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_user_settings(**kwargs)

Retrieves settings for the specified user ID, such as any associated phone number settings.

See also: AWS API Documentation

Request Syntax

response = client.get_user_settings(
    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

{
    'UserSettings': {
        'Telephony': {
            'InboundCalling': True|False,
            'OutboundCalling': True|False,
            'SMS': True|False
        }
    }
}

Response Structure

  • (dict) --

    • UserSettings (dict) --

      The user settings.

      • Telephony (dict) --

        The telephony settings associated with the user.

        • InboundCalling (boolean) --

          Allows or denies inbound calling.

        • OutboundCalling (boolean) --

          Allows or denies outbound calling.

        • SMS (boolean) --

          Allows or denies SMS messaging.

get_voice_connector(**kwargs)

Retrieves details for the specified Amazon Chime Voice Connector, such as timestamps, name, outbound host, and encryption requirements.

See also: AWS API Documentation

Request Syntax

response = client.get_voice_connector(
    VoiceConnectorId='string'
)
Parameters
VoiceConnectorId (string) --

[REQUIRED]

The Amazon Chime Voice Connector ID.

Return type
dict
Returns
Response Syntax
{
    'VoiceConnector': {
        'VoiceConnectorId': 'string',
        'AwsRegion': 'us-east-1'|'us-west-2',
        'Name': 'string',
        'OutboundHostName': 'string',
        'RequireEncryption': True|False,
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --
    • VoiceConnector (dict) --

      The Amazon Chime Voice Connector details.

      • VoiceConnectorId (string) --

        The Amazon Chime Voice Connector ID.

      • AwsRegion (string) --

        The AWS Region in which the Amazon Chime Voice Connector is created. Default: us-east-1 .

      • Name (string) --

        The name of the Amazon Chime Voice Connector.

      • OutboundHostName (string) --

        The outbound host name for the Amazon Chime Voice Connector.

      • RequireEncryption (boolean) --

        Designates whether encryption is required for the Amazon Chime Voice Connector.

      • CreatedTimestamp (datetime) --

        The Amazon Chime Voice Connector creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated Amazon Chime Voice Connector timestamp, in ISO 8601 format.

get_voice_connector_group(**kwargs)

Retrieves details for the specified Amazon Chime Voice Connector group, such as timestamps, name, and associated VoiceConnectorItems .

See also: AWS API Documentation

Request Syntax

response = client.get_voice_connector_group(
    VoiceConnectorGroupId='string'
)
Parameters
VoiceConnectorGroupId (string) --

[REQUIRED]

The Amazon Chime Voice Connector group ID.

Return type
dict
Returns
Response Syntax
{
    'VoiceConnectorGroup': {
        'VoiceConnectorGroupId': 'string',
        'Name': 'string',
        'VoiceConnectorItems': [
            {
                'VoiceConnectorId': 'string',
                'Priority': 123
            },
        ],
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --
    • VoiceConnectorGroup (dict) --

      The Amazon Chime Voice Connector group details.

      • VoiceConnectorGroupId (string) --

        The Amazon Chime Voice Connector group ID.

      • Name (string) --

        The name of the Amazon Chime Voice Connector group.

      • VoiceConnectorItems (list) --

        The Amazon Chime Voice Connectors to which to route inbound calls.

        • (dict) --

          For Amazon Chime Voice Connector groups, the Amazon Chime Voice Connectors to which to route inbound calls. Includes priority configuration settings. Limit: 3 VoiceConnectorItems per Amazon Chime Voice Connector group.

          • VoiceConnectorId (string) --

            The Amazon Chime Voice Connector ID.

          • Priority (integer) --

            The priority associated with the Amazon Chime Voice Connector, with 1 being the highest priority. Higher priority Amazon Chime Voice Connectors are attempted first.

      • CreatedTimestamp (datetime) --

        The Amazon Chime Voice Connector group creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated Amazon Chime Voice Connector group timestamp, in ISO 8601 format.

get_voice_connector_logging_configuration(**kwargs)

Retrieves the logging configuration details for the specified Amazon Chime Voice Connector. Shows whether SIP message logs are enabled for sending to Amazon CloudWatch Logs.

See also: AWS API Documentation

Request Syntax

response = client.get_voice_connector_logging_configuration(
    VoiceConnectorId='string'
)
Parameters
VoiceConnectorId (string) --

[REQUIRED]

The Amazon Chime Voice Connector ID.

Return type
dict
Returns
Response Syntax
{
    'LoggingConfiguration': {
        'EnableSIPLogs': True|False
    }
}

Response Structure

  • (dict) --
    • LoggingConfiguration (dict) --

      The logging configuration details.

      • EnableSIPLogs (boolean) --

        When true, enables SIP message logs for sending to Amazon CloudWatch Logs.

get_voice_connector_origination(**kwargs)

Retrieves origination setting details for the specified Amazon Chime Voice Connector.

See also: AWS API Documentation

Request Syntax

response = client.get_voice_connector_origination(
    VoiceConnectorId='string'
)
Parameters
VoiceConnectorId (string) --

[REQUIRED]

The Amazon Chime Voice Connector ID.

Return type
dict
Returns
Response Syntax
{
    'Origination': {
        'Routes': [
            {
                'Host': 'string',
                'Port': 123,
                'Protocol': 'TCP'|'UDP',
                'Priority': 123,
                'Weight': 123
            },
        ],
        'Disabled': True|False
    }
}

Response Structure

  • (dict) --
    • Origination (dict) --

      The origination setting details.

      • Routes (list) --

        The call distribution properties defined for your SIP hosts. Valid range: Minimum value of 1. Maximum value of 20.

        • (dict) --

          Origination routes define call distribution properties for your SIP hosts to receive inbound calls using your Amazon Chime Voice Connector. Limit: Ten origination routes for each Amazon Chime Voice Connector.

          • Host (string) --

            The FQDN or IP address to contact for origination traffic.

          • Port (integer) --

            The designated origination route port. Defaults to 5060.

          • Protocol (string) --

            The protocol to use for the origination route. Encryption-enabled Amazon Chime Voice Connectors use TCP protocol by default.

          • Priority (integer) --

            The priority associated with the host, with 1 being the highest priority. Higher priority hosts are attempted first.

          • Weight (integer) --

            The weight associated with the host. If hosts are equal in priority, calls are distributed among them based on their relative weight.

      • Disabled (boolean) --

        When origination settings are disabled, inbound calls are not enabled for your Amazon Chime Voice Connector.

get_voice_connector_streaming_configuration(**kwargs)

Retrieves the streaming configuration details for the specified Amazon Chime Voice Connector. Shows whether media streaming is enabled for sending to Amazon Kinesis. It also shows the retention period, in hours, for the Amazon Kinesis data.

See also: AWS API Documentation

Request Syntax

response = client.get_voice_connector_streaming_configuration(
    VoiceConnectorId='string'
)
Parameters
VoiceConnectorId (string) --

[REQUIRED]

The Amazon Chime Voice Connector ID.

Return type
dict
Returns
Response Syntax
{
    'StreamingConfiguration': {
        'DataRetentionInHours': 123,
        'Disabled': True|False
    }
}

Response Structure

  • (dict) --
    • StreamingConfiguration (dict) --

      The streaming configuration details.

      • DataRetentionInHours (integer) --

        The retention period, in hours, for the Amazon Kinesis data.

      • Disabled (boolean) --

        When true, media streaming to Amazon Kinesis is turned off.

get_voice_connector_termination(**kwargs)

Retrieves termination setting details for the specified Amazon Chime Voice Connector.

See also: AWS API Documentation

Request Syntax

response = client.get_voice_connector_termination(
    VoiceConnectorId='string'
)
Parameters
VoiceConnectorId (string) --

[REQUIRED]

The Amazon Chime Voice Connector ID.

Return type
dict
Returns
Response Syntax
{
    'Termination': {
        'CpsLimit': 123,
        'DefaultPhoneNumber': 'string',
        'CallingRegions': [
            'string',
        ],
        'CidrAllowedList': [
            'string',
        ],
        'Disabled': True|False
    }
}

Response Structure

  • (dict) --
    • Termination (dict) --

      The termination setting details.

      • CpsLimit (integer) --

        The limit on calls per second. Max value based on account service limit. Default value of 1.

      • DefaultPhoneNumber (string) --

        The default caller ID phone number.

      • CallingRegions (list) --

        The countries to which calls are allowed, in ISO 3166-1 alpha-2 format. Required.

        • (string) --
      • CidrAllowedList (list) --

        The IP addresses allowed to make calls, in CIDR format. Required.

        • (string) --
      • Disabled (boolean) --

        When termination settings are disabled, outbound calls can not be made.

get_voice_connector_termination_health(**kwargs)

Retrieves information about the last time a SIP OPTIONS ping was received from your SIP infrastructure for the specified Amazon Chime Voice Connector.

See also: AWS API Documentation

Request Syntax

response = client.get_voice_connector_termination_health(
    VoiceConnectorId='string'
)
Parameters
VoiceConnectorId (string) --

[REQUIRED]

The Amazon Chime Voice Connector ID.

Return type
dict
Returns
Response Syntax
{
    'TerminationHealth': {
        'Timestamp': datetime(2015, 1, 1),
        'Source': 'string'
    }
}

Response Structure

  • (dict) --
    • TerminationHealth (dict) --

      The termination health details.

      • Timestamp (datetime) --

        The timestamp, in ISO 8601 format.

      • Source (string) --

        The source IP address.

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 to a maximum of 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 email invitation.

    • (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 email invitation 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_attendees(**kwargs)

Lists the attendees for the specified Amazon Chime SDK meeting. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide .

See also: AWS API Documentation

Request Syntax

response = client.list_attendees(
    MeetingId='string',
    NextToken='string',
    MaxResults=123
)
Parameters
  • MeetingId (string) --

    [REQUIRED]

    The Amazon Chime SDK meeting ID.

  • 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.
Return type

dict

Returns

Response Syntax

{
    'Attendees': [
        {
            'ExternalUserId': 'string',
            'AttendeeId': 'string',
            'JoinToken': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Attendees (list) --

      The Amazon Chime SDK attendee information.

      • (dict) --

        An Amazon Chime SDK meeting attendee. Includes a unique AttendeeId and JoinToken . The JoinToken allows a client to authenticate and join as the specified attendee. The JoinToken expires when the meeting ends or when DeleteAttendee is called. After that, the attendee is unable to join the meeting.

        We recommend securely transferring each JoinToken from your server application to the client so that no other client has access to the token except for the one authorized to represent the attendee.

        • ExternalUserId (string) --

          The Amazon Chime SDK external user ID. Links the attendee to an identity managed by a builder application.

        • AttendeeId (string) --

          The Amazon Chime SDK attendee ID.

        • JoinToken (string) --

          The join token used by the Amazon Chime SDK attendee.

    • NextToken (string) --

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

list_bots(**kwargs)

Lists the bots associated with the administrator's Amazon Chime Enterprise account ID.

See also: AWS API Documentation

Request Syntax

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

    [REQUIRED]

    The Amazon Chime account ID.

  • MaxResults (integer) -- The maximum number of results to return in a single call. The default is 10.
  • NextToken (string) -- The token to use to retrieve the next page of results.
Return type

dict

Returns

Response Syntax

{
    'Bots': [
        {
            'BotId': 'string',
            'UserId': 'string',
            'DisplayName': 'string',
            'BotType': 'ChatBot',
            'Disabled': True|False,
            'CreatedTimestamp': datetime(2015, 1, 1),
            'UpdatedTimestamp': datetime(2015, 1, 1),
            'BotEmail': 'string',
            'SecurityToken': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Bots (list) --

      List of bots and bot details.

      • (dict) --

        A resource that allows Enterprise account administrators to configure an interface to receive events from Amazon Chime.

        • BotId (string) --

          The bot ID.

        • UserId (string) --

          The unique ID for the bot user.

        • DisplayName (string) --

          The bot display name.

        • BotType (string) --

          The bot type.

        • Disabled (boolean) --

          When true, the bot is stopped from running in your account.

        • CreatedTimestamp (datetime) --

          The bot creation timestamp, in ISO 8601 format.

        • UpdatedTimestamp (datetime) --

          The updated bot timestamp, in ISO 8601 format.

        • BotEmail (string) --

          The bot email address.

        • SecurityToken (string) --

          The security token used to authenticate Amazon Chime with the outgoing event endpoint.

    • NextToken (string) --

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

list_meetings(**kwargs)

Lists up to 100 active Amazon Chime SDK meetings. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide .

See also: AWS API Documentation

Request Syntax

response = client.list_meetings(
    NextToken='string',
    MaxResults=123
)
Parameters
  • 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.
Return type

dict

Returns

Response Syntax

{
    'Meetings': [
        {
            'MeetingId': 'string',
            'MediaPlacement': {
                'AudioHostUrl': 'string',
                'ScreenDataUrl': 'string',
                'ScreenSharingUrl': 'string',
                'ScreenViewingUrl': 'string',
                'SignalingUrl': 'string',
                'TurnControlUrl': 'string'
            },
            'MediaRegion': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Meetings (list) --

      The Amazon Chime SDK meeting information.

      • (dict) --

        A meeting created using the Amazon Chime SDK.

        • MeetingId (string) --

          The Amazon Chime SDK meeting ID.

        • MediaPlacement (dict) --

          The media placement for the meeting.

          • AudioHostUrl (string) --

            The audio host URL.

          • ScreenDataUrl (string) --

            The screen data URL.

          • ScreenSharingUrl (string) --

            The screen sharing URL.

          • ScreenViewingUrl (string) --

            The screen viewing URL.

          • SignalingUrl (string) --

            The signaling URL.

          • TurnControlUrl (string) --

            The turn control URL.

        • MediaRegion (string) --

          The Region in which to create the meeting. Available values: us-east-1 , us-west-2 .

    • NextToken (string) --

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

list_phone_number_orders(**kwargs)

Lists the phone number orders for the administrator's Amazon Chime account.

See also: AWS API Documentation

Request Syntax

response = client.list_phone_number_orders(
    NextToken='string',
    MaxResults=123
)
Parameters
  • 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.
Return type

dict

Returns

Response Syntax

{
    'PhoneNumberOrders': [
        {
            'PhoneNumberOrderId': 'string',
            'ProductType': 'BusinessCalling'|'VoiceConnector',
            'Status': 'Processing'|'Successful'|'Failed'|'Partial',
            'OrderedPhoneNumbers': [
                {
                    'E164PhoneNumber': 'string',
                    'Status': 'Processing'|'Acquired'|'Failed'
                },
            ],
            'CreatedTimestamp': datetime(2015, 1, 1),
            'UpdatedTimestamp': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • PhoneNumberOrders (list) --

      The phone number order details.

      • (dict) --

        The details of a phone number order created for Amazon Chime.

        • PhoneNumberOrderId (string) --

          The phone number order ID.

        • ProductType (string) --

          The phone number order product type.

        • Status (string) --

          The status of the phone number order.

        • OrderedPhoneNumbers (list) --

          The ordered phone number details, such as the phone number in E.164 format and the phone number status.

          • (dict) --

            A phone number for which an order has been placed.

            • E164PhoneNumber (string) --

              The phone number, in E.164 format.

            • Status (string) --

              The phone number status.

        • CreatedTimestamp (datetime) --

          The phone number order creation timestamp, in ISO 8601 format.

        • UpdatedTimestamp (datetime) --

          The updated phone number order timestamp, in ISO 8601 format.

    • NextToken (string) --

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

list_phone_numbers(**kwargs)

Lists the phone numbers for the specified Amazon Chime account, Amazon Chime user, Amazon Chime Voice Connector, or Amazon Chime Voice Connector group.

See also: AWS API Documentation

Request Syntax

response = client.list_phone_numbers(
    Status='AcquireInProgress'|'AcquireFailed'|'Unassigned'|'Assigned'|'ReleaseInProgress'|'DeleteInProgress'|'ReleaseFailed'|'DeleteFailed',
    ProductType='BusinessCalling'|'VoiceConnector',
    FilterName='AccountId'|'UserId'|'VoiceConnectorId'|'VoiceConnectorGroupId',
    FilterValue='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • Status (string) -- The phone number status.
  • ProductType (string) -- The phone number product type.
  • FilterName (string) -- The filter to use to limit the number of results.
  • FilterValue (string) -- The value to use for the filter.
  • MaxResults (integer) -- The maximum number of results to return in a single call.
  • NextToken (string) -- The token to use to retrieve the next page of results.
Return type

dict

Returns

Response Syntax

{
    'PhoneNumbers': [
        {
            'PhoneNumberId': 'string',
            'E164PhoneNumber': 'string',
            'Type': 'Local'|'TollFree',
            'ProductType': 'BusinessCalling'|'VoiceConnector',
            'Status': 'AcquireInProgress'|'AcquireFailed'|'Unassigned'|'Assigned'|'ReleaseInProgress'|'DeleteInProgress'|'ReleaseFailed'|'DeleteFailed',
            'Capabilities': {
                'InboundCall': True|False,
                'OutboundCall': True|False,
                'InboundSMS': True|False,
                'OutboundSMS': True|False,
                'InboundMMS': True|False,
                'OutboundMMS': True|False
            },
            'Associations': [
                {
                    'Value': 'string',
                    'Name': 'AccountId'|'UserId'|'VoiceConnectorId'|'VoiceConnectorGroupId',
                    'AssociatedTimestamp': datetime(2015, 1, 1)
                },
            ],
            'CallingName': 'string',
            'CallingNameStatus': 'Unassigned'|'UpdateInProgress'|'UpdateSucceeded'|'UpdateFailed',
            'CreatedTimestamp': datetime(2015, 1, 1),
            'UpdatedTimestamp': datetime(2015, 1, 1),
            'DeletionTimestamp': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • PhoneNumbers (list) --

      The phone number details.

      • (dict) --

        A phone number used for Amazon Chime Business Calling or an Amazon Chime Voice Connector.

        • PhoneNumberId (string) --

          The phone number ID.

        • E164PhoneNumber (string) --

          The phone number, in E.164 format.

        • Type (string) --

          The phone number type.

        • ProductType (string) --

          The phone number product type.

        • Status (string) --

          The phone number status.

        • Capabilities (dict) --

          The phone number capabilities.

          • InboundCall (boolean) --

            Allows or denies inbound calling for the specified phone number.

          • OutboundCall (boolean) --

            Allows or denies outbound calling for the specified phone number.

          • InboundSMS (boolean) --

            Allows or denies inbound SMS messaging for the specified phone number.

          • OutboundSMS (boolean) --

            Allows or denies outbound SMS messaging for the specified phone number.

          • InboundMMS (boolean) --

            Allows or denies inbound MMS messaging for the specified phone number.

          • OutboundMMS (boolean) --

            Allows or denies outbound MMS messaging for the specified phone number.

        • Associations (list) --

          The phone number associations.

          • (dict) --

            The phone number associations, such as Amazon Chime account ID, Amazon Chime user ID, Amazon Chime Voice Connector ID, or Amazon Chime Voice Connector group ID.

            • Value (string) --

              Contains the ID for the entity specified in Name.

            • Name (string) --

              Defines the association with an Amazon Chime account ID, user ID, Amazon Chime Voice Connector ID, or Amazon Chime Voice Connector group ID.

            • AssociatedTimestamp (datetime) --

              The timestamp of the phone number association, in ISO 8601 format.

        • CallingName (string) --

          The outbound calling name associated with the phone number.

        • CallingNameStatus (string) --

          The outbound calling name status.

        • CreatedTimestamp (datetime) --

          The phone number creation timestamp, in ISO 8601 format.

        • UpdatedTimestamp (datetime) --

          The updated phone number timestamp, in ISO 8601 format.

        • DeletionTimestamp (datetime) --

          The deleted phone number timestamp, in ISO 8601 format.

    • NextToken (string) --

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

list_room_memberships(**kwargs)

Lists the membership details for the specified room, such as member IDs, member email addresses, and member names.

See also: AWS API Documentation

Request Syntax

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

    [REQUIRED]

    The Amazon Chime account ID.

  • RoomId (string) --

    [REQUIRED]

    The room ID.

  • MaxResults (integer) -- The maximum number of results to return in a single call.
  • NextToken (string) -- The token to use to retrieve the next page of results.
Return type

dict

Returns

Response Syntax

{
    'RoomMemberships': [
        {
            'RoomId': 'string',
            'Member': {
                'MemberId': 'string',
                'MemberType': 'User'|'Bot'|'Webhook',
                'Email': 'string',
                'FullName': 'string',
                'AccountId': 'string'
            },
            'Role': 'Administrator'|'Member',
            'InvitedBy': 'string',
            'UpdatedTimestamp': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • RoomMemberships (list) --

      The room membership details.

      • (dict) --

        The room membership details.

        • RoomId (string) --

          The room ID.

        • Member (dict) --

          The member details, such as email address, name, member ID, and member type.

          • MemberId (string) --

            The member ID (user ID or bot ID).

          • MemberType (string) --

            The member type.

          • Email (string) --

            The member email address.

          • FullName (string) --

            The member name.

          • AccountId (string) --

            The Amazon Chime account ID.

        • Role (string) --

          The membership role.

        • InvitedBy (string) --

          The identifier of the user that invited the room member.

        • UpdatedTimestamp (datetime) --

          The room membership update timestamp, in ISO 8601 format.

    • NextToken (string) --

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

list_rooms(**kwargs)

Lists the room details for the specified Amazon Chime account. Optionally, filter the results by a member ID (user ID or bot ID) to see a list of rooms that the member belongs to.

See also: AWS API Documentation

Request Syntax

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

    [REQUIRED]

    The Amazon Chime account ID.

  • MemberId (string) -- The member ID (user ID or bot ID).
  • MaxResults (integer) -- The maximum number of results to return in a single call.
  • NextToken (string) -- The token to use to retrieve the next page of results.
Return type

dict

Returns

Response Syntax

{
    'Rooms': [
        {
            'RoomId': 'string',
            'Name': 'string',
            'AccountId': 'string',
            'CreatedBy': 'string',
            'CreatedTimestamp': datetime(2015, 1, 1),
            'UpdatedTimestamp': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Rooms (list) --

      The room details.

      • (dict) --

        The Amazon Chime chat room details.

        • RoomId (string) --

          The room ID.

        • Name (string) --

          The room name.

        • AccountId (string) --

          The Amazon Chime account ID.

        • CreatedBy (string) --

          The identifier of the room creator.

        • CreatedTimestamp (datetime) --

          The room creation timestamp, in ISO 8601 format.

        • UpdatedTimestamp (datetime) --

          The room update timestamp, in ISO 8601 format.

    • 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',
            'PrimaryProvisionedNumber': '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.

        • PrimaryProvisionedNumber (string) --

          The primary phone number associated with 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.

list_voice_connector_groups(**kwargs)

Lists the Amazon Chime Voice Connector groups for the administrator's AWS account.

See also: AWS API Documentation

Request Syntax

response = client.list_voice_connector_groups(
    NextToken='string',
    MaxResults=123
)
Parameters
  • 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.
Return type

dict

Returns

Response Syntax

{
    'VoiceConnectorGroups': [
        {
            'VoiceConnectorGroupId': 'string',
            'Name': 'string',
            'VoiceConnectorItems': [
                {
                    'VoiceConnectorId': 'string',
                    'Priority': 123
                },
            ],
            'CreatedTimestamp': datetime(2015, 1, 1),
            'UpdatedTimestamp': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • VoiceConnectorGroups (list) --

      The details of the Amazon Chime Voice Connector groups.

      • (dict) --

        The Amazon Chime Voice Connector group configuration, including associated Amazon Chime Voice Connectors. You can include Amazon Chime Voice Connectors from different AWS Regions in your group. This creates a fault tolerant mechanism for fallback in case of availability events.

        • VoiceConnectorGroupId (string) --

          The Amazon Chime Voice Connector group ID.

        • Name (string) --

          The name of the Amazon Chime Voice Connector group.

        • VoiceConnectorItems (list) --

          The Amazon Chime Voice Connectors to which to route inbound calls.

          • (dict) --

            For Amazon Chime Voice Connector groups, the Amazon Chime Voice Connectors to which to route inbound calls. Includes priority configuration settings. Limit: 3 VoiceConnectorItems per Amazon Chime Voice Connector group.

            • VoiceConnectorId (string) --

              The Amazon Chime Voice Connector ID.

            • Priority (integer) --

              The priority associated with the Amazon Chime Voice Connector, with 1 being the highest priority. Higher priority Amazon Chime Voice Connectors are attempted first.

        • CreatedTimestamp (datetime) --

          The Amazon Chime Voice Connector group creation timestamp, in ISO 8601 format.

        • UpdatedTimestamp (datetime) --

          The updated Amazon Chime Voice Connector group timestamp, in ISO 8601 format.

    • NextToken (string) --

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

list_voice_connector_termination_credentials(**kwargs)

Lists the SIP credentials for the specified Amazon Chime Voice Connector.

See also: AWS API Documentation

Request Syntax

response = client.list_voice_connector_termination_credentials(
    VoiceConnectorId='string'
)
Parameters
VoiceConnectorId (string) --

[REQUIRED]

The Amazon Chime Voice Connector ID.

Return type
dict
Returns
Response Syntax
{
    'Usernames': [
        'string',
    ]
}

Response Structure

  • (dict) --
    • Usernames (list) --

      A list of user names.

      • (string) --
list_voice_connectors(**kwargs)

Lists the Amazon Chime Voice Connectors for the administrator's AWS account.

See also: AWS API Documentation

Request Syntax

response = client.list_voice_connectors(
    NextToken='string',
    MaxResults=123
)
Parameters
  • 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.
Return type

dict

Returns

Response Syntax

{
    'VoiceConnectors': [
        {
            'VoiceConnectorId': 'string',
            'AwsRegion': 'us-east-1'|'us-west-2',
            'Name': 'string',
            'OutboundHostName': 'string',
            'RequireEncryption': True|False,
            'CreatedTimestamp': datetime(2015, 1, 1),
            'UpdatedTimestamp': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • VoiceConnectors (list) --

      The details of the Amazon Chime Voice Connectors.

      • (dict) --

        The Amazon Chime Voice Connector configuration, including outbound host name and encryption settings.

        • VoiceConnectorId (string) --

          The Amazon Chime Voice Connector ID.

        • AwsRegion (string) --

          The AWS Region in which the Amazon Chime Voice Connector is created. Default: us-east-1 .

        • Name (string) --

          The name of the Amazon Chime Voice Connector.

        • OutboundHostName (string) --

          The outbound host name for the Amazon Chime Voice Connector.

        • RequireEncryption (boolean) --

          Designates whether encryption is required for the Amazon Chime Voice Connector.

        • CreatedTimestamp (datetime) --

          The Amazon Chime Voice Connector creation timestamp, in ISO 8601 format.

        • UpdatedTimestamp (datetime) --

          The updated Amazon Chime Voice Connector timestamp, in ISO 8601 format.

    • 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) --

put_events_configuration(**kwargs)

Creates an events configuration that allows a bot to receive outgoing events sent by Amazon Chime. Choose either an HTTPS endpoint or a Lambda function ARN. For more information, see Bot .

See also: AWS API Documentation

Request Syntax

response = client.put_events_configuration(
    AccountId='string',
    BotId='string',
    OutboundEventsHTTPSEndpoint='string',
    LambdaFunctionArn='string'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • BotId (string) --

    [REQUIRED]

    The bot ID.

  • OutboundEventsHTTPSEndpoint (string) -- HTTPS endpoint that allows the bot to receive outgoing events.
  • LambdaFunctionArn (string) -- Lambda function ARN that allows the bot to receive outgoing events.
Return type

dict

Returns

Response Syntax

{
    'EventsConfiguration': {
        'BotId': 'string',
        'OutboundEventsHTTPSEndpoint': 'string',
        'LambdaFunctionArn': 'string'
    }
}

Response Structure

  • (dict) --

    • EventsConfiguration (dict) --

      The configuration that allows a bot to receive outgoing events. Can be either an HTTPS endpoint or a Lambda function ARN.

      • BotId (string) --

        The bot ID.

      • OutboundEventsHTTPSEndpoint (string) --

        HTTPS endpoint that allows a bot to receive outgoing events.

      • LambdaFunctionArn (string) --

        Lambda function ARN that allows a bot to receive outgoing events.

put_voice_connector_logging_configuration(**kwargs)

Adds a logging configuration for the specified Amazon Chime Voice Connector. The logging configuration specifies whether SIP message logs are enabled for sending to Amazon CloudWatch Logs.

See also: AWS API Documentation

Request Syntax

response = client.put_voice_connector_logging_configuration(
    VoiceConnectorId='string',
    LoggingConfiguration={
        'EnableSIPLogs': True|False
    }
)
Parameters
  • VoiceConnectorId (string) --

    [REQUIRED]

    The Amazon Chime Voice Connector ID.

  • LoggingConfiguration (dict) --

    [REQUIRED]

    The logging configuration details to add.

    • EnableSIPLogs (boolean) --

      When true, enables SIP message logs for sending to Amazon CloudWatch Logs.

Return type

dict

Returns

Response Syntax

{
    'LoggingConfiguration': {
        'EnableSIPLogs': True|False
    }
}

Response Structure

  • (dict) --

    • LoggingConfiguration (dict) --

      The updated logging configuration details.

      • EnableSIPLogs (boolean) --

        When true, enables SIP message logs for sending to Amazon CloudWatch Logs.

put_voice_connector_origination(**kwargs)

Adds origination settings for the specified Amazon Chime Voice Connector.

See also: AWS API Documentation

Request Syntax

response = client.put_voice_connector_origination(
    VoiceConnectorId='string',
    Origination={
        'Routes': [
            {
                'Host': 'string',
                'Port': 123,
                'Protocol': 'TCP'|'UDP',
                'Priority': 123,
                'Weight': 123
            },
        ],
        'Disabled': True|False
    }
)
Parameters
  • VoiceConnectorId (string) --

    [REQUIRED]

    The Amazon Chime Voice Connector ID.

  • Origination (dict) --

    [REQUIRED]

    The origination setting details to add.

    • Routes (list) --

      The call distribution properties defined for your SIP hosts. Valid range: Minimum value of 1. Maximum value of 20.

      • (dict) --

        Origination routes define call distribution properties for your SIP hosts to receive inbound calls using your Amazon Chime Voice Connector. Limit: Ten origination routes for each Amazon Chime Voice Connector.

        • Host (string) --

          The FQDN or IP address to contact for origination traffic.

        • Port (integer) --

          The designated origination route port. Defaults to 5060.

        • Protocol (string) --

          The protocol to use for the origination route. Encryption-enabled Amazon Chime Voice Connectors use TCP protocol by default.

        • Priority (integer) --

          The priority associated with the host, with 1 being the highest priority. Higher priority hosts are attempted first.

        • Weight (integer) --

          The weight associated with the host. If hosts are equal in priority, calls are distributed among them based on their relative weight.

    • Disabled (boolean) --

      When origination settings are disabled, inbound calls are not enabled for your Amazon Chime Voice Connector.

Return type

dict

Returns

Response Syntax

{
    'Origination': {
        'Routes': [
            {
                'Host': 'string',
                'Port': 123,
                'Protocol': 'TCP'|'UDP',
                'Priority': 123,
                'Weight': 123
            },
        ],
        'Disabled': True|False
    }
}

Response Structure

  • (dict) --

    • Origination (dict) --

      The updated origination setting details.

      • Routes (list) --

        The call distribution properties defined for your SIP hosts. Valid range: Minimum value of 1. Maximum value of 20.

        • (dict) --

          Origination routes define call distribution properties for your SIP hosts to receive inbound calls using your Amazon Chime Voice Connector. Limit: Ten origination routes for each Amazon Chime Voice Connector.

          • Host (string) --

            The FQDN or IP address to contact for origination traffic.

          • Port (integer) --

            The designated origination route port. Defaults to 5060.

          • Protocol (string) --

            The protocol to use for the origination route. Encryption-enabled Amazon Chime Voice Connectors use TCP protocol by default.

          • Priority (integer) --

            The priority associated with the host, with 1 being the highest priority. Higher priority hosts are attempted first.

          • Weight (integer) --

            The weight associated with the host. If hosts are equal in priority, calls are distributed among them based on their relative weight.

      • Disabled (boolean) --

        When origination settings are disabled, inbound calls are not enabled for your Amazon Chime Voice Connector.

put_voice_connector_streaming_configuration(**kwargs)

Adds a streaming configuration for the specified Amazon Chime Voice Connector. The streaming configuration specifies whether media streaming is enabled for sending to Amazon Kinesis. It also sets the retention period, in hours, for the Amazon Kinesis data.

See also: AWS API Documentation

Request Syntax

response = client.put_voice_connector_streaming_configuration(
    VoiceConnectorId='string',
    StreamingConfiguration={
        'DataRetentionInHours': 123,
        'Disabled': True|False
    }
)
Parameters
  • VoiceConnectorId (string) --

    [REQUIRED]

    The Amazon Chime Voice Connector ID.

  • StreamingConfiguration (dict) --

    [REQUIRED]

    The streaming configuration details to add.

    • DataRetentionInHours (integer) -- [REQUIRED]

      The retention period, in hours, for the Amazon Kinesis data.

    • Disabled (boolean) --

      When true, media streaming to Amazon Kinesis is turned off.

Return type

dict

Returns

Response Syntax

{
    'StreamingConfiguration': {
        'DataRetentionInHours': 123,
        'Disabled': True|False
    }
}

Response Structure

  • (dict) --

    • StreamingConfiguration (dict) --

      The updated streaming configuration details.

      • DataRetentionInHours (integer) --

        The retention period, in hours, for the Amazon Kinesis data.

      • Disabled (boolean) --

        When true, media streaming to Amazon Kinesis is turned off.

put_voice_connector_termination(**kwargs)

Adds termination settings for the specified Amazon Chime Voice Connector.

See also: AWS API Documentation

Request Syntax

response = client.put_voice_connector_termination(
    VoiceConnectorId='string',
    Termination={
        'CpsLimit': 123,
        'DefaultPhoneNumber': 'string',
        'CallingRegions': [
            'string',
        ],
        'CidrAllowedList': [
            'string',
        ],
        'Disabled': True|False
    }
)
Parameters
  • VoiceConnectorId (string) --

    [REQUIRED]

    The Amazon Chime Voice Connector ID.

  • Termination (dict) --

    [REQUIRED]

    The termination setting details to add.

    • CpsLimit (integer) --

      The limit on calls per second. Max value based on account service limit. Default value of 1.

    • DefaultPhoneNumber (string) --

      The default caller ID phone number.

    • CallingRegions (list) --

      The countries to which calls are allowed, in ISO 3166-1 alpha-2 format. Required.

      • (string) --
    • CidrAllowedList (list) --

      The IP addresses allowed to make calls, in CIDR format. Required.

      • (string) --
    • Disabled (boolean) --

      When termination settings are disabled, outbound calls can not be made.

Return type

dict

Returns

Response Syntax

{
    'Termination': {
        'CpsLimit': 123,
        'DefaultPhoneNumber': 'string',
        'CallingRegions': [
            'string',
        ],
        'CidrAllowedList': [
            'string',
        ],
        'Disabled': True|False
    }
}

Response Structure

  • (dict) --

    • Termination (dict) --

      The updated termination setting details.

      • CpsLimit (integer) --

        The limit on calls per second. Max value based on account service limit. Default value of 1.

      • DefaultPhoneNumber (string) --

        The default caller ID phone number.

      • CallingRegions (list) --

        The countries to which calls are allowed, in ISO 3166-1 alpha-2 format. Required.

        • (string) --
      • CidrAllowedList (list) --

        The IP addresses allowed to make calls, in CIDR format. Required.

        • (string) --
      • Disabled (boolean) --

        When termination settings are disabled, outbound calls can not be made.

put_voice_connector_termination_credentials(**kwargs)

Adds termination SIP credentials for the specified Amazon Chime Voice Connector.

See also: AWS API Documentation

Request Syntax

response = client.put_voice_connector_termination_credentials(
    VoiceConnectorId='string',
    Credentials=[
        {
            'Username': 'string',
            'Password': 'string'
        },
    ]
)
Parameters
  • VoiceConnectorId (string) --

    [REQUIRED]

    The Amazon Chime Voice Connector ID.

  • Credentials (list) --

    The termination SIP credentials.

    • (dict) --

      The SIP credentials used to authenticate requests to your Amazon Chime Voice Connector.

      • Username (string) --

        The RFC2617 compliant user name associated with the SIP credentials, in US-ASCII format.

      • Password (string) --

        The RFC2617 compliant password associated with the SIP credentials, in US-ASCII format.

Returns

None

regenerate_security_token(**kwargs)

Regenerates the security token for a bot.

See also: AWS API Documentation

Request Syntax

response = client.regenerate_security_token(
    AccountId='string',
    BotId='string'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • BotId (string) --

    [REQUIRED]

    The bot ID.

Return type

dict

Returns

Response Syntax

{
    'Bot': {
        'BotId': 'string',
        'UserId': 'string',
        'DisplayName': 'string',
        'BotType': 'ChatBot',
        'Disabled': True|False,
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1),
        'BotEmail': 'string',
        'SecurityToken': 'string'
    }
}

Response Structure

  • (dict) --

    • Bot (dict) --

      A resource that allows Enterprise account administrators to configure an interface to receive events from Amazon Chime.

      • BotId (string) --

        The bot ID.

      • UserId (string) --

        The unique ID for the bot user.

      • DisplayName (string) --

        The bot display name.

      • BotType (string) --

        The bot type.

      • Disabled (boolean) --

        When true, the bot is stopped from running in your account.

      • CreatedTimestamp (datetime) --

        The bot creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated bot timestamp, in ISO 8601 format.

      • BotEmail (string) --

        The bot email address.

      • SecurityToken (string) --

        The security token used to authenticate Amazon Chime with the outgoing event endpoint.

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',
        'PrimaryProvisionedNumber': '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.

      • PrimaryProvisionedNumber (string) --

        The primary phone number associated with 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.

restore_phone_number(**kwargs)

Moves a phone number from the Deletion queue back into the phone number Inventory .

See also: AWS API Documentation

Request Syntax

response = client.restore_phone_number(
    PhoneNumberId='string'
)
Parameters
PhoneNumberId (string) --

[REQUIRED]

The phone number.

Return type
dict
Returns
Response Syntax
{
    'PhoneNumber': {
        'PhoneNumberId': 'string',
        'E164PhoneNumber': 'string',
        'Type': 'Local'|'TollFree',
        'ProductType': 'BusinessCalling'|'VoiceConnector',
        'Status': 'AcquireInProgress'|'AcquireFailed'|'Unassigned'|'Assigned'|'ReleaseInProgress'|'DeleteInProgress'|'ReleaseFailed'|'DeleteFailed',
        'Capabilities': {
            'InboundCall': True|False,
            'OutboundCall': True|False,
            'InboundSMS': True|False,
            'OutboundSMS': True|False,
            'InboundMMS': True|False,
            'OutboundMMS': True|False
        },
        'Associations': [
            {
                'Value': 'string',
                'Name': 'AccountId'|'UserId'|'VoiceConnectorId'|'VoiceConnectorGroupId',
                'AssociatedTimestamp': datetime(2015, 1, 1)
            },
        ],
        'CallingName': 'string',
        'CallingNameStatus': 'Unassigned'|'UpdateInProgress'|'UpdateSucceeded'|'UpdateFailed',
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1),
        'DeletionTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --
    • PhoneNumber (dict) --

      The phone number details.

      • PhoneNumberId (string) --

        The phone number ID.

      • E164PhoneNumber (string) --

        The phone number, in E.164 format.

      • Type (string) --

        The phone number type.

      • ProductType (string) --

        The phone number product type.

      • Status (string) --

        The phone number status.

      • Capabilities (dict) --

        The phone number capabilities.

        • InboundCall (boolean) --

          Allows or denies inbound calling for the specified phone number.

        • OutboundCall (boolean) --

          Allows or denies outbound calling for the specified phone number.

        • InboundSMS (boolean) --

          Allows or denies inbound SMS messaging for the specified phone number.

        • OutboundSMS (boolean) --

          Allows or denies outbound SMS messaging for the specified phone number.

        • InboundMMS (boolean) --

          Allows or denies inbound MMS messaging for the specified phone number.

        • OutboundMMS (boolean) --

          Allows or denies outbound MMS messaging for the specified phone number.

      • Associations (list) --

        The phone number associations.

        • (dict) --

          The phone number associations, such as Amazon Chime account ID, Amazon Chime user ID, Amazon Chime Voice Connector ID, or Amazon Chime Voice Connector group ID.

          • Value (string) --

            Contains the ID for the entity specified in Name.

          • Name (string) --

            Defines the association with an Amazon Chime account ID, user ID, Amazon Chime Voice Connector ID, or Amazon Chime Voice Connector group ID.

          • AssociatedTimestamp (datetime) --

            The timestamp of the phone number association, in ISO 8601 format.

      • CallingName (string) --

        The outbound calling name associated with the phone number.

      • CallingNameStatus (string) --

        The outbound calling name status.

      • CreatedTimestamp (datetime) --

        The phone number creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated phone number timestamp, in ISO 8601 format.

      • DeletionTimestamp (datetime) --

        The deleted phone number timestamp, in ISO 8601 format.

search_available_phone_numbers(**kwargs)

Searches phone numbers that can be ordered.

See also: AWS API Documentation

Request Syntax

response = client.search_available_phone_numbers(
    AreaCode='string',
    City='string',
    Country='string',
    State='string',
    TollFreePrefix='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • AreaCode (string) -- The area code used to filter results.
  • City (string) -- The city used to filter results.
  • Country (string) -- The country used to filter results.
  • State (string) -- The state used to filter results.
  • TollFreePrefix (string) -- The toll-free prefix that you use to filter results.
  • MaxResults (integer) -- The maximum number of results to return in a single call.
  • NextToken (string) -- The token to use to retrieve the next page of results.
Return type

dict

Returns

Response Syntax

{
    'E164PhoneNumbers': [
        'string',
    ]
}

Response Structure

  • (dict) --

    • E164PhoneNumbers (list) --

      List of phone numbers, in E.164 format.

      • (string) --

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_bot(**kwargs)

Updates the status of the specified bot, such as starting or stopping the bot from running in your Amazon Chime Enterprise account.

See also: AWS API Documentation

Request Syntax

response = client.update_bot(
    AccountId='string',
    BotId='string',
    Disabled=True|False
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • BotId (string) --

    [REQUIRED]

    The bot ID.

  • Disabled (boolean) -- When true, stops the specified bot from running in your account.
Return type

dict

Returns

Response Syntax

{
    'Bot': {
        'BotId': 'string',
        'UserId': 'string',
        'DisplayName': 'string',
        'BotType': 'ChatBot',
        'Disabled': True|False,
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1),
        'BotEmail': 'string',
        'SecurityToken': 'string'
    }
}

Response Structure

  • (dict) --

    • Bot (dict) --

      The updated bot details.

      • BotId (string) --

        The bot ID.

      • UserId (string) --

        The unique ID for the bot user.

      • DisplayName (string) --

        The bot display name.

      • BotType (string) --

        The bot type.

      • Disabled (boolean) --

        When true, the bot is stopped from running in your account.

      • CreatedTimestamp (datetime) --

        The bot creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated bot timestamp, in ISO 8601 format.

      • BotEmail (string) --

        The bot email address.

      • SecurityToken (string) --

        The security token used to authenticate Amazon Chime with the outgoing event endpoint.

update_global_settings(**kwargs)

Updates global settings for the administrator's AWS account, such as Amazon Chime Business Calling and Amazon Chime Voice Connector settings.

See also: AWS API Documentation

Request Syntax

response = client.update_global_settings(
    BusinessCalling={
        'CdrBucket': 'string'
    },
    VoiceConnector={
        'CdrBucket': 'string'
    }
)
Parameters
  • BusinessCalling (dict) --

    [REQUIRED]

    The Amazon Chime Business Calling settings.

    • CdrBucket (string) --

      The Amazon S3 bucket designated for call detail record storage.

  • VoiceConnector (dict) --

    [REQUIRED]

    The Amazon Chime Voice Connector settings.

    • CdrBucket (string) --

      The Amazon S3 bucket designated for call detail record storage.

Returns

None

update_phone_number(**kwargs)

Updates phone number details, such as product type or calling name, for the specified phone number ID. You can update one phone number detail at a time. For example, you can update either the product type or the calling name in one action.

For toll-free numbers, you must use the Amazon Chime Voice Connector product type.

Updates to outbound calling names can take up to 72 hours to complete. Pending updates to outbound calling names must be complete before you can request another update.

See also: AWS API Documentation

Request Syntax

response = client.update_phone_number(
    PhoneNumberId='string',
    ProductType='BusinessCalling'|'VoiceConnector',
    CallingName='string'
)
Parameters
  • PhoneNumberId (string) --

    [REQUIRED]

    The phone number ID.

  • ProductType (string) -- The product type.
  • CallingName (string) -- The outbound calling name associated with the phone number.
Return type

dict

Returns

Response Syntax

{
    'PhoneNumber': {
        'PhoneNumberId': 'string',
        'E164PhoneNumber': 'string',
        'Type': 'Local'|'TollFree',
        'ProductType': 'BusinessCalling'|'VoiceConnector',
        'Status': 'AcquireInProgress'|'AcquireFailed'|'Unassigned'|'Assigned'|'ReleaseInProgress'|'DeleteInProgress'|'ReleaseFailed'|'DeleteFailed',
        'Capabilities': {
            'InboundCall': True|False,
            'OutboundCall': True|False,
            'InboundSMS': True|False,
            'OutboundSMS': True|False,
            'InboundMMS': True|False,
            'OutboundMMS': True|False
        },
        'Associations': [
            {
                'Value': 'string',
                'Name': 'AccountId'|'UserId'|'VoiceConnectorId'|'VoiceConnectorGroupId',
                'AssociatedTimestamp': datetime(2015, 1, 1)
            },
        ],
        'CallingName': 'string',
        'CallingNameStatus': 'Unassigned'|'UpdateInProgress'|'UpdateSucceeded'|'UpdateFailed',
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1),
        'DeletionTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    • PhoneNumber (dict) --

      The updated phone number details.

      • PhoneNumberId (string) --

        The phone number ID.

      • E164PhoneNumber (string) --

        The phone number, in E.164 format.

      • Type (string) --

        The phone number type.

      • ProductType (string) --

        The phone number product type.

      • Status (string) --

        The phone number status.

      • Capabilities (dict) --

        The phone number capabilities.

        • InboundCall (boolean) --

          Allows or denies inbound calling for the specified phone number.

        • OutboundCall (boolean) --

          Allows or denies outbound calling for the specified phone number.

        • InboundSMS (boolean) --

          Allows or denies inbound SMS messaging for the specified phone number.

        • OutboundSMS (boolean) --

          Allows or denies outbound SMS messaging for the specified phone number.

        • InboundMMS (boolean) --

          Allows or denies inbound MMS messaging for the specified phone number.

        • OutboundMMS (boolean) --

          Allows or denies outbound MMS messaging for the specified phone number.

      • Associations (list) --

        The phone number associations.

        • (dict) --

          The phone number associations, such as Amazon Chime account ID, Amazon Chime user ID, Amazon Chime Voice Connector ID, or Amazon Chime Voice Connector group ID.

          • Value (string) --

            Contains the ID for the entity specified in Name.

          • Name (string) --

            Defines the association with an Amazon Chime account ID, user ID, Amazon Chime Voice Connector ID, or Amazon Chime Voice Connector group ID.

          • AssociatedTimestamp (datetime) --

            The timestamp of the phone number association, in ISO 8601 format.

      • CallingName (string) --

        The outbound calling name associated with the phone number.

      • CallingNameStatus (string) --

        The outbound calling name status.

      • CreatedTimestamp (datetime) --

        The phone number creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated phone number timestamp, in ISO 8601 format.

      • DeletionTimestamp (datetime) --

        The deleted phone number timestamp, in ISO 8601 format.

update_phone_number_settings(**kwargs)

Updates the phone number settings for the administrator's AWS account, such as the default outbound calling name. You can update the default outbound calling name once every seven days. Outbound calling names can take up to 72 hours to update.

See also: AWS API Documentation

Request Syntax

response = client.update_phone_number_settings(
    CallingName='string'
)
Parameters
CallingName (string) --

[REQUIRED]

The default outbound calling name for the account.

Returns
None
update_room(**kwargs)

Updates room details, such as the room name.

See also: AWS API Documentation

Request Syntax

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

    [REQUIRED]

    The Amazon Chime account ID.

  • RoomId (string) --

    [REQUIRED]

    The room ID.

  • Name (string) -- The room name.
Return type

dict

Returns

Response Syntax

{
    'Room': {
        'RoomId': 'string',
        'Name': 'string',
        'AccountId': 'string',
        'CreatedBy': 'string',
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    • Room (dict) --

      The room details.

      • RoomId (string) --

        The room ID.

      • Name (string) --

        The room name.

      • AccountId (string) --

        The Amazon Chime account ID.

      • CreatedBy (string) --

        The identifier of the room creator.

      • CreatedTimestamp (datetime) --

        The room creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The room update timestamp, in ISO 8601 format.

update_room_membership(**kwargs)

Updates room membership details, such as member role. The member role designates whether the member is a chat room administrator or a general chat room member. Member role can only be updated for user IDs.

See also: AWS API Documentation

Request Syntax

response = client.update_room_membership(
    AccountId='string',
    RoomId='string',
    MemberId='string',
    Role='Administrator'|'Member'
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • RoomId (string) --

    [REQUIRED]

    The room ID.

  • MemberId (string) --

    [REQUIRED]

    The member ID.

  • Role (string) -- The role of the member.
Return type

dict

Returns

Response Syntax

{
    'RoomMembership': {
        'RoomId': 'string',
        'Member': {
            'MemberId': 'string',
            'MemberType': 'User'|'Bot'|'Webhook',
            'Email': 'string',
            'FullName': 'string',
            'AccountId': 'string'
        },
        'Role': 'Administrator'|'Member',
        'InvitedBy': 'string',
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    • RoomMembership (dict) --

      The room membership details.

      • RoomId (string) --

        The room ID.

      • Member (dict) --

        The member details, such as email address, name, member ID, and member type.

        • MemberId (string) --

          The member ID (user ID or bot ID).

        • MemberType (string) --

          The member type.

        • Email (string) --

          The member email address.

        • FullName (string) --

          The member name.

        • AccountId (string) --

          The Amazon Chime account ID.

      • Role (string) --

        The membership role.

      • InvitedBy (string) --

        The identifier of the user that invited the room member.

      • UpdatedTimestamp (datetime) --

        The room membership update timestamp, in ISO 8601 format.

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',
        'PrimaryProvisionedNumber': '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.

      • PrimaryProvisionedNumber (string) --

        The primary phone number associated with 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_user_settings(**kwargs)

Updates the settings for the specified user, such as phone number settings.

See also: AWS API Documentation

Request Syntax

response = client.update_user_settings(
    AccountId='string',
    UserId='string',
    UserSettings={
        'Telephony': {
            'InboundCalling': True|False,
            'OutboundCalling': True|False,
            'SMS': True|False
        }
    }
)
Parameters
  • AccountId (string) --

    [REQUIRED]

    The Amazon Chime account ID.

  • UserId (string) --

    [REQUIRED]

    The user ID.

  • UserSettings (dict) --

    [REQUIRED]

    The user settings to update.

    • Telephony (dict) -- [REQUIRED]

      The telephony settings associated with the user.

      • InboundCalling (boolean) -- [REQUIRED]

        Allows or denies inbound calling.

      • OutboundCalling (boolean) -- [REQUIRED]

        Allows or denies outbound calling.

      • SMS (boolean) -- [REQUIRED]

        Allows or denies SMS messaging.

Returns

None

update_voice_connector(**kwargs)

Updates details for the specified Amazon Chime Voice Connector.

See also: AWS API Documentation

Request Syntax

response = client.update_voice_connector(
    VoiceConnectorId='string',
    Name='string',
    RequireEncryption=True|False
)
Parameters
  • VoiceConnectorId (string) --

    [REQUIRED]

    The Amazon Chime Voice Connector ID.

  • Name (string) --

    [REQUIRED]

    The name of the Amazon Chime Voice Connector.

  • RequireEncryption (boolean) --

    [REQUIRED]

    When enabled, requires encryption for the Amazon Chime Voice Connector.

Return type

dict

Returns

Response Syntax

{
    'VoiceConnector': {
        'VoiceConnectorId': 'string',
        'AwsRegion': 'us-east-1'|'us-west-2',
        'Name': 'string',
        'OutboundHostName': 'string',
        'RequireEncryption': True|False,
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    • VoiceConnector (dict) --

      The updated Amazon Chime Voice Connector details.

      • VoiceConnectorId (string) --

        The Amazon Chime Voice Connector ID.

      • AwsRegion (string) --

        The AWS Region in which the Amazon Chime Voice Connector is created. Default: us-east-1 .

      • Name (string) --

        The name of the Amazon Chime Voice Connector.

      • OutboundHostName (string) --

        The outbound host name for the Amazon Chime Voice Connector.

      • RequireEncryption (boolean) --

        Designates whether encryption is required for the Amazon Chime Voice Connector.

      • CreatedTimestamp (datetime) --

        The Amazon Chime Voice Connector creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated Amazon Chime Voice Connector timestamp, in ISO 8601 format.

update_voice_connector_group(**kwargs)

Updates details for the specified Amazon Chime Voice Connector group, such as the name and Amazon Chime Voice Connector priority ranking.

See also: AWS API Documentation

Request Syntax

response = client.update_voice_connector_group(
    VoiceConnectorGroupId='string',
    Name='string',
    VoiceConnectorItems=[
        {
            'VoiceConnectorId': 'string',
            'Priority': 123
        },
    ]
)
Parameters
  • VoiceConnectorGroupId (string) --

    [REQUIRED]

    The Amazon Chime Voice Connector group ID.

  • Name (string) --

    [REQUIRED]

    The name of the Amazon Chime Voice Connector group.

  • VoiceConnectorItems (list) --

    [REQUIRED]

    The VoiceConnectorItems to associate with the group.

    • (dict) --

      For Amazon Chime Voice Connector groups, the Amazon Chime Voice Connectors to which to route inbound calls. Includes priority configuration settings. Limit: 3 VoiceConnectorItems per Amazon Chime Voice Connector group.

      • VoiceConnectorId (string) -- [REQUIRED]

        The Amazon Chime Voice Connector ID.

      • Priority (integer) -- [REQUIRED]

        The priority associated with the Amazon Chime Voice Connector, with 1 being the highest priority. Higher priority Amazon Chime Voice Connectors are attempted first.

Return type

dict

Returns

Response Syntax

{
    'VoiceConnectorGroup': {
        'VoiceConnectorGroupId': 'string',
        'Name': 'string',
        'VoiceConnectorItems': [
            {
                'VoiceConnectorId': 'string',
                'Priority': 123
            },
        ],
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    • VoiceConnectorGroup (dict) --

      The updated Amazon Chime Voice Connector group details.

      • VoiceConnectorGroupId (string) --

        The Amazon Chime Voice Connector group ID.

      • Name (string) --

        The name of the Amazon Chime Voice Connector group.

      • VoiceConnectorItems (list) --

        The Amazon Chime Voice Connectors to which to route inbound calls.

        • (dict) --

          For Amazon Chime Voice Connector groups, the Amazon Chime Voice Connectors to which to route inbound calls. Includes priority configuration settings. Limit: 3 VoiceConnectorItems per Amazon Chime Voice Connector group.

          • VoiceConnectorId (string) --

            The Amazon Chime Voice Connector ID.

          • Priority (integer) --

            The priority associated with the Amazon Chime Voice Connector, with 1 being the highest priority. Higher priority Amazon Chime Voice Connectors are attempted first.

      • CreatedTimestamp (datetime) --

        The Amazon Chime Voice Connector group creation timestamp, in ISO 8601 format.

      • UpdatedTimestamp (datetime) --

        The updated Amazon Chime Voice Connector group timestamp, in ISO 8601 format.

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',
            'PrimaryProvisionedNumber': '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.

        • PrimaryProvisionedNumber (string) --

          The primary phone number associated with 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.