This documentation is for Version 1 of the Amazon CLI only. For documentation related to Version 2 of the Amazon CLI, see the Version 2 User Guide.
Amazon Chime examples using Amazon CLI
The following code examples show you how to perform actions and implement common scenarios by using the Amazon Command Line Interface with Amazon Chime.
Actions are code excerpts from larger programs and must be run in context. While actions show you how to call individual service functions, you can see actions in context in their related scenarios.
Each example includes a link to the complete source code, where you can find instructions on how to set up and run the code in context.
Topics
Actions
The following code example shows how to use associate-phone-number-with-user
.
- Amazon CLI
-
To associate a phone number with a user
The following
associate-phone-number-with-user
example associates the specified phone number with a user.aws chime associate-phone-number-with-user \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --user-id1ab2345c-67de-8901-f23g-45h678901j2k
\ --e164-phone-number"+12065550100"
This command produces no output.
For more information, see Managing User Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see AssociatePhoneNumberWithUser
in Amazon CLI Command Reference.
-
The following code example shows how to use associate-phone-numbers-with-voice-connector-group
.
- Amazon CLI
-
To associate phone numbers with an Amazon Chime Voice Connector group
The following
associate-phone-numbers-with-voice-connector-group
example associates the specified phone numbers with an Amazon Chime Voice Connector group.aws chime associate-phone-numbers-with-voice-connector-group \ --voice-connector-group-id
123a456b-c7d8-90e1-fg23-4h567jkl8901
\ --e164-phone-numbers"+12065550100"
"+12065550101"
\ --force-associateOutput:
{ "PhoneNumberErrors": [] }
For more information, see Working with Amazon Chime Voice Connector groups
in the Amazon Chime Administration Guide. -
For API details, see AssociatePhoneNumbersWithVoiceConnectorGroup
in Amazon CLI Command Reference.
-
The following code example shows how to use associate-phone-numbers-with-voice-connector
.
- Amazon CLI
-
To associate phone numbers with an Amazon Chime Voice Connector
The following
associate-phone-numbers-with-voice-connector
example associates the specified phone numbers with an Amazon Chime Voice Connector.aws chime associate-phone-numbers-with-voice-connector \ --voice-connector-id
abcdef1ghij2klmno3pqr4
\ --e164-phone-numbers"+12065550100"
"+12065550101"
--force-associateOutput:
{ "PhoneNumberErrors": [] }
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see AssociatePhoneNumbersWithVoiceConnector
in Amazon CLI Command Reference.
-
The following code example shows how to use associate-signin-delegate-groups-with-account
.
- Amazon CLI
-
To associate sign-in delegate groups
The following
associate-signin-delegate-groups-with-account
example associates the specified sign-in delegate group with the specified Amazon Chime account.aws chime associate-signin-delegate-groups-with-account \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --signin-delegate-groupsGroupName=my_users
This command produces no output.
For more information, see Managing User Access and Permissions
in the Amazon Chime Administration Guide. -
For API details, see AssociateSigninDelegateGroupsWithAccount
in Amazon CLI Command Reference.
-
The following code example shows how to use batch-create-room-membership
.
- Amazon CLI
-
To create multiple room memberships
The following
batch-create-room-membership
example adds multiple users to a chat room as chat room members. It also assigns administrator and member roles to the users.aws chime batch-create-room-membership \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --room-idabcd1e2d-3e45-6789-01f2-3g45h67i890j
\ --membership-item-list"MemberId=1ab2345c-67de-8901-f23g-45h678901j2k,Role=Administrator"
"MemberId=2ab2345c-67de-8901-f23g-45h678901j2k,Role=Member"
Output:
{ "ResponseMetadata": { "RequestId": "169ba401-d886-475f-8b3f-e01eac6fadfb", "HTTPStatusCode": 201, "HTTPHeaders": { "x-amzn-requestid": "169ba401-d886-475f-8b3f-e01eac6fadfb", "content-type": "application/json", "content-length": "13", "date": "Mon, 02 Dec 2019 22:46:58 GMT", "connection": "keep-alive" }, "RetryAttempts": 0 }, "Errors": [] }
For more information, see Creating a Chat Room
in the Amazon Chime User Guide. -
For API details, see BatchCreateRoomMembership
in Amazon CLI Command Reference.
-
The following code example shows how to use batch-delete-phone-number
.
- Amazon CLI
-
To delete multiple phone numbers
The following
batch-delete-phone-number
example deletes all of the specified phone numbers.aws chime batch-delete-phone-number \ --phone-number-ids
"%2B12065550100"
"%2B12065550101"
This command produces no output. Output:
{ "PhoneNumberErrors": [] }
For more information, see Working with Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see BatchDeletePhoneNumber
in Amazon CLI Command Reference.
-
The following code example shows how to use batch-suspend-user
.
- Amazon CLI
-
To suspend multiple users
The following
batch-suspend-user
example suspends the listed users from the specified Amazon Chime account.aws chime batch-suspend-user \ --account-id
a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
\ --user-id-list"a1b2c3d4-5678-90ab-cdef-22222EXAMPLE"
"a1b2c3d4-5678-90ab-cdef-33333EXAMPLE"
"a1b2c3d4-5678-90ab-cdef-44444EXAMPLE"
Output:
{ "UserErrors": [] }
-
For API details, see BatchSuspendUser
in Amazon CLI Command Reference.
-
The following code example shows how to use batch-unsuspend-user
.
- Amazon CLI
-
To unsuspend multiple users
The following
batch-unsuspend-user
example removes any previous suspension for the listed users on the specified Amazon Chime account.aws chime batch-unsuspend-user \ --account-id
a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
\ --user-id-list"a1b2c3d4-5678-90ab-cdef-22222EXAMPLE"
"a1b2c3d4-5678-90ab-cdef-33333EXAMPLE"
"a1b2c3d4-5678-90ab-cdef-44444EXAMPLE"
Output:
{ "UserErrors": [] }
-
For API details, see BatchUnsuspendUser
in Amazon CLI Command Reference.
-
The following code example shows how to use batch-update-phone-number
.
- Amazon CLI
-
To update several phone number product types at the same time
The following
batch-update-phone-number
example updates the product types for all of the specified phone numbers.aws chime batch-update-phone-number \ --update-phone-number-request-items
PhoneNumberId=%2B12065550100,ProductType=BusinessCalling
PhoneNumberId=%2B12065550101,ProductType=BusinessCalling
Output:
{ "PhoneNumberErrors": [] }
To update several phone number calling names at the same time
The following
batch-update-phone-number
example updates the calling names for all of the specified phone numbers.aws chime batch-update-phone-number \ --update-phone-number-request-items
PhoneNumberId=%2B14013143874,CallingName=phonenumber1
PhoneNumberId=%2B14013144061,CallingName=phonenumber2
Output:
{ "PhoneNumberErrors": [] }
For more information, see Working with Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see BatchUpdatePhoneNumber
in Amazon CLI Command Reference.
-
The following code example shows how to use batch-update-user
.
- Amazon CLI
-
To update multiple users in a single command
The following
batch-update-user
example updates theLicenseType
for each of the listed users in the specified Amazon Chime account.aws chime batch-update-user \ --account-id
a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
--update-user-request-items"UserId=a1b2c3d4-5678-90ab-cdef-22222EXAMPLE,LicenseType=Basic"
"UserId=a1b2c3d4-5678-90ab-cdef-33333EXAMPLE,LicenseType=Basic"
Output:
{ "UserErrors": [] }
-
For API details, see BatchUpdateUser
in Amazon CLI Command Reference.
-
The following code example shows how to use create-account
.
- Amazon CLI
-
To create an account
The following
create-account
example creates an Amazon Chime account under the administrator's Amazon account.aws chime create-account \ --name
MyChimeAccount
Output:
{ "Account": { "AwsAccountId": "111122223333", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "Name": "MyChimeAccount", "AccountType": "Team", "CreatedTimestamp": "2019-01-04T17:11:22.003Z", "DefaultLicense": "Pro", "SupportedLicenses": [ "Basic", "Pro" ], "SigninDelegateGroups": [ { "GroupName": "myGroup" }, ] } }
For more information, see Getting Started
in the Amazon Chime Administration Guide. -
For API details, see CreateAccount
in Amazon CLI Command Reference.
-
The following code example shows how to use create-bot
.
- Amazon CLI
-
To create an Amazon Chime bot
The following
create-bot
example creates a bot for the specified Amazon Chime Enterprise account.aws chime create-bot \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --display-name"myBot"
\ --domain"example.com"
Output:
{ "Bot": { "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k", "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k", "DisplayName": "myBot (Bot)", "BotType": "ChatBot", "Disabled": false, "CreatedTimestamp": "2019-09-09T18:05:56.749Z", "UpdatedTimestamp": "2019-09-09T18:05:56.749Z", "BotEmail": "myBot-chimebot@example.com", "SecurityToken": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" } }
For more information, see Integrate a Chat Bot with Amazon Chime
in the Amazon Chime Developer Guide. -
For API details, see CreateBot
in Amazon CLI Command Reference.
-
The following code example shows how to use create-phone-number-order
.
- Amazon CLI
-
To create a phone number order
The following
create-phone-number-order
example creates a phone number order for the specified phone numbers.aws chime create-phone-number-order \ --product-type
VoiceConnector
\ --e164-phone-numbers"+12065550100"
"+12065550101"
"+12065550102"
Output:
{ "PhoneNumberOrder": { "PhoneNumberOrderId": "abc12345-de67-89f0-123g-h45i678j9012", "ProductType": "VoiceConnector", "Status": "Processing", "OrderedPhoneNumbers": [ { "E164PhoneNumber": "+12065550100", "Status": "Processing" }, { "E164PhoneNumber": "+12065550101", "Status": "Processing" }, { "E164PhoneNumber": "+12065550102", "Status": "Processing" } ], "CreatedTimestamp": "2019-08-09T21:35:21.427Z", "UpdatedTimestamp": "2019-08-09T21:35:22.408Z" } }
For more information, see Working with Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see CreatePhoneNumberOrder
in Amazon CLI Command Reference.
-
The following code example shows how to use create-proxy-session
.
- Amazon CLI
-
To create a proxy session
The following
create-proxy-session
example creates a proxy session with voice and SMS capabilities.aws chime create-proxy-session \ --voice-connector-id
abcdef1ghij2klmno3pqr4
\ --participant-phone-numbers"+14015550101"
"+12065550100"
\ --capabilities"Voice"
"SMS"
Output:
{ "ProxySession": { "VoiceConnectorId": "abcdef1ghij2klmno3pqr4", "ProxySessionId": "123a4bc5-67d8-901e-2f3g-h4ghjk56789l", "Status": "Open", "ExpiryMinutes": 60, "Capabilities": [ "SMS", "Voice" ], "CreatedTimestamp": "2020-04-15T16:10:10.288Z", "UpdatedTimestamp": "2020-04-15T16:10:10.288Z", "Participants": [ { "PhoneNumber": "+12065550100", "ProxyPhoneNumber": "+19135550199" }, { "PhoneNumber": "+14015550101", "ProxyPhoneNumber": "+19135550199" } ] } }
For more information, see Proxy Phone Sessions
in the Amazon Chime Developer Guide. -
For API details, see CreateProxySession
in Amazon CLI Command Reference.
-
The following code example shows how to use create-room-membership
.
- Amazon CLI
-
To create a room membership
The following
create-room-membership
example adds the specified user to the chat room as a chat room member.aws chime create-room-membership \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --room-idabcd1e2d-3e45-6789-01f2-3g45h67i890j
\ --member-id1ab2345c-67de-8901-f23g-45h678901j2k
Output:
{ "RoomMembership": { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Member": { "MemberId": "1ab2345c-67de-8901-f23g-45h678901j2k", "MemberType": "User", "Email": "janed@example.com", "FullName": "Jane Doe", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45" }, "Role": "Member", "InvitedBy": "arn:aws:iam::111122223333:user/alejandro", "UpdatedTimestamp": "2019-12-02T22:36:41.969Z" } }
For more information, see Creating a Chat Room
in the Amazon Chime User Guide. -
For API details, see CreateRoomMembership
in Amazon CLI Command Reference.
-
The following code example shows how to use create-room
.
- Amazon CLI
-
To create a chat room
The following
create-room
example creates a chat room for the specified Amazon Chime account.aws chime create-room \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --namechatRoom
Output:
{ "Room": { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Name": "chatRoom", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45", "CreatedBy": "arn:aws:iam::111122223333:user/alejandro", "CreatedTimestamp": "2019-12-02T22:29:31.549Z", "UpdatedTimestamp": "2019-12-02T22:29:31.549Z" } }
For more information, see Creating a Chat Room
in the Amazon Chime User Guide. -
For API details, see CreateRoom
in Amazon CLI Command Reference.
-
The following code example shows how to use create-user
.
- Amazon CLI
-
To create a user profile for a shared device
The following
create-user
example creates a shared device profile for the specified email address.aws chime create-user \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --emailroomdevice@example.com
\ --user-typeSharedDevice
Output:
{ "User": { "UserId": "1ab2345c-67de-8901-f23g-45h678901j2k", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45", "PrimaryEmail": "roomdevice@example.com", "DisplayName": "Room Device", "LicenseType": "Pro", "UserType": "SharedDevice", "UserRegistrationStatus": "Registered", "RegisteredOn": "2020-01-15T22:38:09.806Z", "AlexaForBusinessMetadata": { "IsAlexaForBusinessEnabled": false } } }
For more information, see Preparing for Setup
in the Amazon Chime Administration Guide. -
For API details, see CreateUser
in Amazon CLI Command Reference.
-
The following code example shows how to use create-voice-connector-group
.
- Amazon CLI
-
To create an Amazon Chime Voice Connector group
The following
create-voice-connector-group
example creates an Amazon Chime Voice Connector group that includes the specified Amazon Chime Voice Connector.aws chime create-voice-connector-group \ --name
myGroup
\ --voice-connector-itemsVoiceConnectorId=abcdef1ghij2klmno3pqr4,Priority=2
Output:
{ "VoiceConnectorGroup": { "VoiceConnectorGroupId": "123a456b-c7d8-90e1-fg23-4h567jkl8901", "Name": "myGroup", "VoiceConnectorItems": [], "CreatedTimestamp": "2019-09-18T16:38:34.734Z", "UpdatedTimestamp": "2019-09-18T16:38:34.734Z" } }
For more information, see Working with Amazon Chime Voice Connector Groups
in the Amazon Chime Administration Guide. -
For API details, see CreateVoiceConnectorGroup
in Amazon CLI Command Reference.
-
The following code example shows how to use create-voice-connector
.
- Amazon CLI
-
To create an Amazon Chime Voice Connector
The following
create-voice-connector
example creates an Amazon Chime Voice Connector in the specified Amazon Region, with encryption enabled.aws chime create-voice-connector \ --name
newVoiceConnector
\ --aws-regionus-west-2
\ --require-encryptionOutput:
{ "VoiceConnector": { "VoiceConnectorId": "abcdef1ghij2klmno3pqr4", "AwsRegion": "us-west-2", "Name": "newVoiceConnector", "OutboundHostName": "abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws", "RequireEncryption": true, "CreatedTimestamp": "2019-09-18T20:34:01.352Z", "UpdatedTimestamp": "2019-09-18T20:34:01.352Z" } }
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see CreateVoiceConnector
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-account
.
- Amazon CLI
-
To delete an account
The following
delete-account
example deletes the specified account.aws chime delete-account --account-id
a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
This command produces no output.
For more information, see Deleting Your Account
in the Amazon Chime Administration Guide. -
For API details, see DeleteAccount
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-phone-number
.
- Amazon CLI
-
To delete a phone number
The following
delete-phone-number
example moves the specified phone number into the deletion queue.aws chime delete-phone-number \ --phone-number-id
"+12065550100"
This command produces no output.
For more information, see Working with Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see DeletePhoneNumber
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-proxy-session
.
- Amazon CLI
-
To delete a proxy session
The following
delete-proxy-session
example deletes the specified proxy session.aws chime delete-proxy-session \ --voice-connector-id
abcdef1ghij2klmno3pqr4
\ --proxy-session-id123a4bc5-67d8-901e-2f3g-h4ghjk56789l
This command produces no output.
For more information, see Proxy Phone Sessions
in the Amazon Chime Developer Guide. -
For API details, see DeleteProxySession
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-room-membership
.
- Amazon CLI
-
To remove a user as a member of a chat room
The following
delete-room-membership
example removes the specified member from the specified chat room.aws chime delete-room-membership \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --room-idabcd1e2d-3e45-6789-01f2-3g45h67i890j
\ --member-id1ab2345c-67de-8901-f23g-45h678901j2k
This command produces no output.
For more information, see Creating a Chat Room
in the Amazon Chime User Guide. -
For API details, see DeleteRoomMembership
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-room
.
- Amazon CLI
-
To delete a chat room
The following
delete-room
example deletes the specified chat room and removes the chat room memberships.aws chime delete-room \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --room-idabcd1e2d-3e45-6789-01f2-3g45h67i890j
This command produces no output.
For more information, see Creating a Chat Room
in the Amazon Chime User Guide. -
For API details, see DeleteRoom
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-voice-connector-group
.
- Amazon CLI
-
title
The following
delete-voice-connector-group
example deletes the specified Amazon Chime Voice Connector group.aws chime delete-voice-connector-group \ --voice-connector-group-id
123a456b-c7d8-90e1-fg23-4h567jkl8901
This command produces no output.
For more information, see Working with Amazon Chime Voice Connector Groups
in the Amazon Chime Administration Guide. -
For API details, see DeleteVoiceConnectorGroup
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-voice-connector-origination
.
- Amazon CLI
-
To delete origination settings
The following
delete-voice-connector-origination
example deletes the origination host, port, protocol, priority, and weight from the specified Amazon Chime Voice Connector.aws chime delete-voice-connector-origination \ --voice-connector-id
abcdef1ghij2klmno3pqr4
This command produces no output.
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see DeleteVoiceConnectorOrigination
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-voice-connector-proxy
.
- Amazon CLI
-
To delete a proxy configuration
The following
delete-voice-connector-proxy
example deletes the proxy configuration from your Amazon Chime Voice Connector.aws chime delete-voice-connector-proxy \ --voice-connector-id
abcdef1ghij2klmno3pqr4
This command produces no output.
For more information, see Proxy Phone Sessions
in the Amazon Chime Developer Guide. -
For API details, see DeleteVoiceConnectorProxy
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-voice-connector-streaming-configuration
.
- Amazon CLI
-
To delete a streaming configuration
The following
delete-voice-connector-streaming-configuration
example deletes the streaming configuration for the specified Amazon Chime Voice Connector.aws chime delete-voice-connector-streaming-configuration \ --voice-connector-id
abcdef1ghij2klmno3pqr4
This command produces no output.
For more information, see Streaming Amazon Chime Voice Connector Data to Kinesis
in the Amazon Chime Administration Guide. -
For API details, see DeleteVoiceConnectorStreamingConfiguration
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-voice-connector-termination-credentials
.
- Amazon CLI
-
To delete termination credentials
The following
delete-voice-connector-termination-credentials
example deletes the termination credentials for the specified user name and Amazon Chime Voice Connector.aws chime delete-voice-connector-termination-credentials \ --voice-connector-id
abcdef1ghij2klmno3pqr4
\ --usernames"jdoe"
This command produces no output.
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see DeleteVoiceConnectorTerminationCredentials
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-voice-connector-termination
.
- Amazon CLI
-
To delete termination settings
The following
delete-voice-connector-termination
example deletes the termination settings for the specified Amazon Chime Voice Connector.aws chime delete-voice-connector-termination \ --voice-connector-id
abcdef1ghij2klmno3pqr4
This command produces no output.
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see DeleteVoiceConnectorTermination
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-voice-connector
.
- Amazon CLI
-
To delete an Amazon Chime Voice Connector
The following
delete-voice-connector
example doesthisaws chime delete-voice-connector \ --voice-connector-id
abcdef1ghij2klmno3pqr4
This command produces no output.
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see DeleteVoiceConnector
in Amazon CLI Command Reference.
-
The following code example shows how to use disassociate-phone-number-from-user
.
- Amazon CLI
-
To disassociate a phone number from a user
The following
disassociate-phone-number-from-user
example disassociates a phone number from the specified user.aws chime disassociate-phone-number-from-user \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --user-id1ab2345c-67de-8901-f23g-45h678901j2k
This command produces no output.
For more information, see Managing User Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see DisassociatePhoneNumberFromUser
in Amazon CLI Command Reference.
-
The following code example shows how to use disassociate-phone-numbers-from-voice-connector-group
.
- Amazon CLI
-
To disassociate phone numbers from an Amazon Chime Voice Connector group
The following
disassociate-phone-numbers-from-voice-connector-group
example disassociates the specified phone numbers from an Amazon Chime Voice Connector group.aws chime disassociate-phone-numbers-from-voice-connector-group \ --voice-connector-group-id
123a456b-c7d8-90e1-fg23-4h567jkl8901
\ --e164-phone-numbers"+12065550100"
"+12065550101"
Output:
{ "PhoneNumberErrors": [] }
For more information, see Working with Amazon Chime Voice Connector Groups
in the Amazon Chime Administration Guide. -
For API details, see DisassociatePhoneNumbersFromVoiceConnectorGroup
in Amazon CLI Command Reference.
-
The following code example shows how to use disassociate-phone-numbers-from-voice-connector
.
- Amazon CLI
-
To disassociate phone numbers from an Amazon Chime Voice Connector
The following
disassociate-phone-numbers-from-voice-connector
example disassociates the specified phone numbers from an Amazon Chime Voice Connector.aws chime disassociate-phone-numbers-from-voice-connector \ --voice-connector-id
abcdef1ghij2klmno3pqr4
\ --e164-phone-numbers"+12065550100"
"+12065550101"
Output:
{ "PhoneNumberErrors": [] }
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see DisassociatePhoneNumbersFromVoiceConnector
in Amazon CLI Command Reference.
-
The following code example shows how to use disassociate-signin-delegate-groups-from-account
.
- Amazon CLI
-
To disassociate sign-in delegate groups
The following
disassociate-signin-delegate-groups-from-account
example disassociates the specified sign-in delegate group from the specified Amazon Chime account.aws chime disassociate-signin-delegate-groups-from-account \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --group-names"my_users"
This command produces no output.
For more information, see Managing User Access and Permissions
in the Amazon Chime Administration Guide. -
For API details, see DisassociateSigninDelegateGroupsFromAccount
in Amazon CLI Command Reference.
-
The following code example shows how to use get-account-settings
.
- Amazon CLI
-
To retrieve settings for an account
The following
get-account-settings
example retrieves the account settings for the specified account.aws chime get-account-settings --account-id
a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
Output:
{ "AccountSettings": { "DisableRemoteControl": false, "EnableDialOut": false } }
For more information, see Managing Your Amazon Chime Accounts
in the Amazon Chime Administration Guide. -
For API details, see GetAccountSettings
in Amazon CLI Command Reference.
-
The following code example shows how to use get-account
.
- Amazon CLI
-
To retrieve the details for an account
The following
get-account
example retrieves the details for the specified Amazon Chime account.aws chime get-account \ --account-id
a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
Output:
{ "Account": { "AwsAccountId": "111122223333", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "Name": "EnterpriseDirectory", "AccountType": "EnterpriseDirectory", "CreatedTimestamp": "2018-12-20T18:38:02.181Z", "DefaultLicense": "Pro", "SupportedLicenses": [ "Basic", "Pro" ], "SigninDelegateGroups": [ { "GroupName": "myGroup" }, ] } }
For more information, see Managing Your Amazon Chime Accounts
in the Amazon Chime Administration Guide. -
For API details, see GetAccount
in Amazon CLI Command Reference.
-
The following code example shows how to use get-bot
.
- Amazon CLI
-
To retrieve details about a bot
The following
get-bot
example displays the details for the specified bot.aws chime get-bot \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --bot-id123abcd4-5ef6-789g-0h12-34j56789012k
Output:
{ "Bot": { "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k", "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k", "DisplayName": "myBot (Bot)", "BotType": "ChatBot", "Disabled": false, "CreatedTimestamp": "2019-09-09T18:05:56.749Z", "UpdatedTimestamp": "2019-09-09T18:05:56.749Z", "BotEmail": "myBot-chimebot@example.com", "SecurityToken": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" } }
For more information, see Update Chat Bots
in the Amazon Chime Developer Guide. -
For API details, see GetBot
in Amazon CLI Command Reference.
-
The following code example shows how to use get-global-settings
.
- Amazon CLI
-
To get global settings
The following
get-global-settings
example retrieves the S3 bucket names used to store call detail records for Amazon Chime Business Calling and Amazon Chime Voice Connectors associated with the administrator's Amazon account.aws chime get-global-settings
Output:
{ "BusinessCalling": { "CdrBucket": "s3bucket" }, "VoiceConnector": { "CdrBucket": "s3bucket" } }
For more information, see Managing Global Settings
in the Amazon Chime Administration Guide. -
For API details, see GetGlobalSettings
in Amazon CLI Command Reference.
-
The following code example shows how to use get-phone-number-order
.
- Amazon CLI
-
To get details for a phone number order
The following
get-phone-number-order
example displays the details of the specified phone number order.aws chime get-phone-number-order \ --phone-number-order-id
abc12345-de67-89f0-123g-h45i678j9012
Output:
{ "PhoneNumberOrder": { "PhoneNumberOrderId": "abc12345-de67-89f0-123g-h45i678j9012", "ProductType": "VoiceConnector", "Status": "Partial", "OrderedPhoneNumbers": [ { "E164PhoneNumber": "+12065550100", "Status": "Acquired" }, { "E164PhoneNumber": "+12065550101", "Status": "Acquired" }, { "E164PhoneNumber": "+12065550102", "Status": "Failed" } ], "CreatedTimestamp": "2019-08-09T21:35:21.427Z", "UpdatedTimestamp": "2019-08-09T21:35:31.926Z" } }
For more information, see Working with Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see GetPhoneNumberOrder
in Amazon CLI Command Reference.
-
The following code example shows how to use get-phone-number-settings
.
- Amazon CLI
-
To retrieve an outbound calling name
The following
get-phone-number-settings
example retrieves the default outbound calling name for the calling user's Amazon account.aws chime get-phone-number-settings
This command produces no output. Output:
{ "CallingName": "myName", "CallingNameUpdatedTimestamp": "2019-10-28T18:56:42.911Z" }
For more information, see Working with Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see GetPhoneNumberSettings
in Amazon CLI Command Reference.
-
The following code example shows how to use get-phone-number
.
- Amazon CLI
-
To get phone number details
The following
get-phone-number
example displays the details of the specified phone number.aws chime get-phone-number \ --phone-number-id
+12065550100
Output:
{ "PhoneNumber": { "PhoneNumberId": "%2B12065550100", "E164PhoneNumber": "+12065550100", "Type": "Local", "ProductType": "VoiceConnector", "Status": "Unassigned", "Capabilities": { "InboundCall": true, "OutboundCall": true, "InboundSMS": true, "OutboundSMS": true, "InboundMMS": true, "OutboundMMS": true }, "Associations": [ { "Value": "abcdef1ghij2klmno3pqr4", "Name": "VoiceConnectorId", "AssociatedTimestamp": "2019-10-28T18:40:37.453Z" } ], "CallingNameStatus": "UpdateInProgress", "CreatedTimestamp": "2019-08-09T21:35:21.445Z", "UpdatedTimestamp": "2019-08-09T21:35:31.745Z" } }
For more information, see Working with Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see GetPhoneNumber
in Amazon CLI Command Reference.
-
The following code example shows how to use get-proxy-session
.
- Amazon CLI
-
To get proxy session details
The following
get-proxy-session
example lists the details of the specified proxy session.aws chime get-proxy-session \ --voice-connector-id
abcdef1ghij2klmno3pqr4
\ --proxy-session-id123a4bc5-67d8-901e-2f3g-h4ghjk56789l
Output:
{ "ProxySession": { "VoiceConnectorId": "abcdef1ghij2klmno3pqr4", "ProxySessionId": "123a4bc5-67d8-901e-2f3g-h4ghjk56789l", "Status": "Open", "ExpiryMinutes": 60, "Capabilities": [ "SMS", "Voice" ], "CreatedTimestamp": "2020-04-15T16:10:10.288Z", "UpdatedTimestamp": "2020-04-15T16:10:10.288Z", "Participants": [ { "PhoneNumber": "+12065550100", "ProxyPhoneNumber": "+19135550199" }, { "PhoneNumber": "+14015550101", "ProxyPhoneNumber": "+19135550199" } ] } }
For more information, see Proxy Phone Sessions
in the Amazon Chime Developer Guide. -
For API details, see GetProxySession
in Amazon CLI Command Reference.
-
The following code example shows how to use get-room
.
- Amazon CLI
-
To get the details about a chat room
The following
get-room
example displays details about the specified chat room.aws chime get-room \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --room-idabcd1e2d-3e45-6789-01f2-3g45h67i890j
Output:
{ "Room": { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Name": "chatRoom", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45", "CreatedBy": "arn:aws:iam::111122223333:user/alejandro", "CreatedTimestamp": "2019-12-02T22:29:31.549Z", "UpdatedTimestamp": "2019-12-02T22:29:31.549Z" } }
For more information, see Creating a Chat Room
in the Amazon Chime User Guide. -
For API details, see GetRoom
in Amazon CLI Command Reference.
-
The following code example shows how to use get-user-settings
.
- Amazon CLI
-
To retrieve user settings
The following
get-user-settings
example displays the specified user settings.aws chime get-user-settings \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --user-id1ab2345c-67de-8901-f23g-45h678901j2k
Output:
{ "UserSettings": { "Telephony": { "InboundCalling": true, "OutboundCalling": true, "SMS": true } } }
For more information, see Managing User Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see GetUserSettings
in Amazon CLI Command Reference.
-
The following code example shows how to use get-user
.
- Amazon CLI
-
To get details about a user
The following
get-user
example retrieves the details for the specified user.aws chime get-user \ --account-id
a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
\ --user-ida1b2c3d4-5678-90ab-cdef-22222EXAMPLE
Output:
{ "User": { "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "PrimaryEmail": "marthar@example.com", "DisplayName": "Martha Rivera", "LicenseType": "Pro", "UserRegistrationStatus": "Registered", "RegisteredOn": "2018-12-20T18:45:25.231Z", "InvitedOn": "2018-12-20T18:45:25.231Z", "AlexaForBusinessMetadata": { "IsAlexaForBusinessEnabled": False, "AlexaForBusinessRoomArn": "null" }, "PersonalPIN": "XXXXXXXXXX" } }
For more information, see Managing Users
in the Amazon Chime Administration Guide. -
For API details, see GetUser
in Amazon CLI Command Reference.
-
The following code example shows how to use get-voice-connector-group
.
- Amazon CLI
-
To get details for an Amazon Chime Voice Connector group
The following
get-voice-connector-group
example displays details for the specified Amazon Chime Voice Connector group.aws chime get-voice-connector-group \ --voice-connector-group-id
123a456b-c7d8-90e1-fg23-4h567jkl8901
Output:
{ "VoiceConnectorGroup": { "VoiceConnectorGroupId": "123a456b-c7d8-90e1-fg23-4h567jkl8901", "Name": "myGroup", "VoiceConnectorItems": [], "CreatedTimestamp": "2019-09-18T16:38:34.734Z", "UpdatedTimestamp": "2019-09-18T16:38:34.734Z" } }
For more information, see Working with Amazon Chime Voice Connector Groups
in the Amazon Chime Administration Guide. -
For API details, see GetVoiceConnectorGroup
in Amazon CLI Command Reference.
-
The following code example shows how to use get-voice-connector-logging-configuration
.
- Amazon CLI
-
To get logging configuration details
The following
get-voice-connector-logging-configuration
example retreives the logging configuration details for the specified Amazon Chime Voice Connector.aws chime get-voice-connector-logging-configuration \ --voice-connector-id
abcdef1ghij2klmno3pqr4
Output:
{ "LoggingConfiguration": { "EnableSIPLogs": true } }
For more information, see Streaming Amazon Chime Voice Connector Media to Kinesis
in the Amazon Chime Administration Guide. -
For API details, see GetVoiceConnectorLoggingConfiguration
in Amazon CLI Command Reference.
-
The following code example shows how to use get-voice-connector-origination
.
- Amazon CLI
-
To retrieve origination settings
The following
get-voice-connector-origination
example retrieves the origination host, port, protocol, priority, and weight for the specified Amazon Chime Voice Connector.aws chime get-voice-connector-origination \ --voice-connector-id
abcdef1ghij2klmno3pqr4
Output:
{ "Origination": { "Routes": [ { "Host": "10.24.34.0", "Port": 1234, "Protocol": "TCP", "Priority": 1, "Weight": 5 } ], "Disabled": false } }
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see GetVoiceConnectorOrigination
in Amazon CLI Command Reference.
-
The following code example shows how to use get-voice-connector-proxy
.
- Amazon CLI
-
To get proxy configuration details
The following
get-voice-connector-proxy
example gets the proxy configuration details for your Amazon Chime Voice Connector.aws chime get-voice-connector-proxy \ --voice-connector-id
abcdef1ghij2klmno3pqr4
Output:
{ "Proxy": { "DefaultSessionExpiryMinutes": 60, "Disabled": false, "PhoneNumberCountries": [ "US" ] } }
For more information, see Proxy Phone Sessions
in the Amazon Chime Developer Guide. -
For API details, see GetVoiceConnectorProxy
in Amazon CLI Command Reference.
-
The following code example shows how to use get-voice-connector-streaming-configuration
.
- Amazon CLI
-
To get streaming configuration details
The following
get-voice-connector-streaming-configuration
example gets the streaming configuration details for the specified Amazon Chime Voice Connector.aws chime get-voice-connector-streaming-configuration \ --voice-connector-id
abcdef1ghij2klmno3pqr4
Output:
{ "StreamingConfiguration": { "DataRetentionInHours": 24, "Disabled": false } }
For more information, see Streaming Amazon Chime Voice Connector Data to Kinesis
in the Amazon Chime Administration Guide. -
For API details, see GetVoiceConnectorStreamingConfiguration
in Amazon CLI Command Reference.
-
The following code example shows how to use get-voice-connector-termination-health
.
- Amazon CLI
-
To retrieve termination health details
The following
get-voice-connector-termination-health
example retrieves the termination health details for the specified Amazon Chime Voice Connector.aws chime get-voice-connector-termination-health \ --voice-connector-id
abcdef1ghij2klmno3pqr4
Output:
{ "TerminationHealth": { "Timestamp": "Fri Aug 23 16:45:55 UTC 2019", "Source": "10.24.34.0" } }
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see GetVoiceConnectorTerminationHealth
in Amazon CLI Command Reference.
-
The following code example shows how to use get-voice-connector-termination
.
- Amazon CLI
-
To retrieve termination settings
The following
get-voice-connector-termination
example retrieves the termination settings for the specified Amazon Chime Voice Connector.aws chime get-voice-connector-termination \ --voice-connector-id
abcdef1ghij2klmno3pqr4
This command produces no output. Output:
{ "Termination": { "CpsLimit": 1, "DefaultPhoneNumber": "+12065550100", "CallingRegions": [ "US" ], "CidrAllowedList": [ "10.24.34.0/23" ], "Disabled": false } }
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see GetVoiceConnectorTermination
in Amazon CLI Command Reference.
-
The following code example shows how to use get-voice-connector
.
- Amazon CLI
-
To get details for an Amazon Chime Voice Connector
The following
get-voice-connector
example displays the details of the specified Amazon Chime Voice Connector.aws chime get-voice-connector \ --voice-connector-id
abcdef1ghij2klmno3pqr4
Output:
{ "VoiceConnector": { "VoiceConnectorId": "abcdef1ghij2klmno3pqr4", "AwsRegion": "us-west-2", "Name": "newVoiceConnector", "OutboundHostName": "abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws", "RequireEncryption": true, "CreatedTimestamp": "2019-09-18T20:34:01.352Z", "UpdatedTimestamp": "2019-09-18T20:34:01.352Z" } }
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see GetVoiceConnector
in Amazon CLI Command Reference.
-
The following code example shows how to use invite-users
.
- Amazon CLI
-
To invite users to join Amazon Chime
The following
invite-users
example sends an email to invite a user to the specified Amazon Chime account.aws chime invite-users \ --account-id
a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
\ --user-email-list"alejandror@example.com"
"janed@example.com"
Output:
{ "Invites": [ { "InviteId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "Status": "Pending", "EmailAddress": "alejandror@example.com", "EmailStatus": "Sent" } { "InviteId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "Status": "Pending", "EmailAddress": "janed@example.com", "EmailStatus": "Sent" } ] }
For more information, see Inviting and Suspending Users
in the Amazon Chime Administration Guide. -
For API details, see InviteUsers
in Amazon CLI Command Reference.
-
The following code example shows how to use list-accounts
.
- Amazon CLI
-
To get a list of accounts
The following
list-accounts
example retrieves a list of the Amazon Chime accounts in the administrator's Amazon account.aws chime list-accounts
Output:
{ "Accounts": [ { "AwsAccountId": "111122223333", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "Name": "First Chime Account", "AccountType": "EnterpriseDirectory", "CreatedTimestamp": "2018-12-20T18:38:02.181Z", "DefaultLicense": "Pro", "SupportedLicenses": [ "Basic", "Pro" ], "SigninDelegateGroups": [ { "GroupName": "myGroup" }, ] }, { "AwsAccountId": "111122223333", "AccountId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "Name": "Second Chime Account", "AccountType": "Team", "CreatedTimestamp": "2018-09-04T21:44:22.292Z", "DefaultLicense": "Pro", "SupportedLicenses": [ "Basic", "Pro" ], "SigninDelegateGroups": [ { "GroupName": "myGroup" }, ] } ] }
For more information, see Managing Your Amazon Chime Accounts
in the Amazon Chime Administration Guide. -
For API details, see ListAccounts
in Amazon CLI Command Reference.
-
The following code example shows how to use list-bots
.
- Amazon CLI
-
To retrieve a list of bots
The following
list-bots
example lists the bots associated with the specified Amazon Chime Enterprise account.aws chime list-bots \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
Output:
{ "Bot": { "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k", "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k", "DisplayName": "myBot (Bot)", "BotType": "ChatBot", "Disabled": false, "CreatedTimestamp": "2019-09-09T18:05:56.749Z", "UpdatedTimestamp": "2019-09-09T18:05:56.749Z", "BotEmail": "myBot-chimebot@example.com", "SecurityToken": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" } }
For more information, see Use Chat Bots with Amazon Chime
in the Amazon Chime Developer Guide. -
For API details, see ListBots
in Amazon CLI Command Reference.
-
The following code example shows how to use list-phone-number-orders
.
- Amazon CLI
-
To list phone number orders
The following
list-phone-number-orders
example lists the phone number orders associated with the Amazon Chime administrator's account.aws chime list-phone-number-orders
Output:
{ "PhoneNumberOrders": [ { "PhoneNumberOrderId": "abc12345-de67-89f0-123g-h45i678j9012", "ProductType": "VoiceConnector", "Status": "Partial", "OrderedPhoneNumbers": [ { "E164PhoneNumber": "+12065550100", "Status": "Acquired" }, { "E164PhoneNumber": "+12065550101", "Status": "Acquired" }, { "E164PhoneNumber": "+12065550102", "Status": "Failed" } ], "CreatedTimestamp": "2019-08-09T21:35:21.427Z", "UpdatedTimestamp": "2019-08-09T21:35:31.926Z" } { "PhoneNumberOrderId": "cba54321-ed76-09f5-321g-h54i876j2109", "ProductType": "BusinessCalling", "Status": "Partial", "OrderedPhoneNumbers": [ { "E164PhoneNumber": "+12065550103", "Status": "Acquired" }, { "E164PhoneNumber": "+12065550104", "Status": "Acquired" }, { "E164PhoneNumber": "+12065550105", "Status": "Failed" } ], "CreatedTimestamp": "2019-08-09T21:35:21.427Z", "UpdatedTimestamp": "2019-08-09T21:35:31.926Z" } ] }
For more information, see Working with Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see ListPhoneNumberOrders
in Amazon CLI Command Reference.
-
The following code example shows how to use list-phone-numbers
.
- Amazon CLI
-
To list phone numbers for an Amazon Chime account
The following
list-phone-numbers
example lists the phone numbers associated with the administrator's Amazon Chime account.aws chime list-phone-numbers
This command produces no output. Output:
{ "PhoneNumbers": [ { "PhoneNumberId": "%2B12065550100", "E164PhoneNumber": "+12065550100", "Type": "Local", "ProductType": "VoiceConnector", "Status": "Assigned", "Capabilities": { "InboundCall": true, "OutboundCall": true, "InboundSMS": true, "OutboundSMS": true, "InboundMMS": true, "OutboundMMS": true }, "Associations": [ { "Value": "abcdef1ghij2klmno3pqr4", "Name": "VoiceConnectorId", "AssociatedTimestamp": "2019-10-28T18:40:37.453Z" } ], "CallingNameStatus": "UpdateInProgress", "CreatedTimestamp": "2019-08-12T22:10:20.521Z", "UpdatedTimestamp": "2019-10-28T18:42:07.964Z" }, { "PhoneNumberId": "%2B12065550101", "E164PhoneNumber": "+12065550101", "Type": "Local", "ProductType": "VoiceConnector", "Status": "Assigned", "Capabilities": { "InboundCall": true, "OutboundCall": true, "InboundSMS": true, "OutboundSMS": true, "InboundMMS": true, "OutboundMMS": true }, "Associations": [ { "Value": "abcdef1ghij2klmno3pqr4", "Name": "VoiceConnectorId", "AssociatedTimestamp": "2019-10-28T18:40:37.511Z" } ], "CallingNameStatus": "UpdateInProgress", "CreatedTimestamp": "2019-08-12T22:10:20.521Z", "UpdatedTimestamp": "2019-10-28T18:42:07.960Z" } ] }
For more information, see Working with Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see ListPhoneNumbers
in Amazon CLI Command Reference.
-
The following code example shows how to use list-proxy-sessions
.
- Amazon CLI
-
To list proxy sessions
The following
list-proxy-sessions
example lists the proxy sessions for your Amazon Chime Voice Connector.aws chime list-proxy-sessions \ --voice-connector-id
abcdef1ghij2klmno3pqr4
Output:
{ "ProxySession": { "VoiceConnectorId": "abcdef1ghij2klmno3pqr4", "ProxySessionId": "123a4bc5-67d8-901e-2f3g-h4ghjk56789l", "Status": "Open", "ExpiryMinutes": 60, "Capabilities": [ "SMS", "Voice" ], "CreatedTimestamp": "2020-04-15T16:10:10.288Z", "UpdatedTimestamp": "2020-04-15T16:10:10.288Z", "Participants": [ { "PhoneNumber": "+12065550100", "ProxyPhoneNumber": "+19135550199" }, { "PhoneNumber": "+14015550101", "ProxyPhoneNumber": "+19135550199" } ] } }
For more information, see Proxy Phone Sessions
in the Amazon Chime Developer Guide. -
For API details, see ListProxySessions
in Amazon CLI Command Reference.
-
The following code example shows how to use list-room-memberships
.
- Amazon CLI
-
To list room memberships
The following
list-room-memberships
example displays a list of the membership details for the specified chat room.aws chime list-room-memberships \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --room-idabcd1e2d-3e45-6789-01f2-3g45h67i890j
Output:
{ "RoomMemberships": [ { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Member": { "MemberId": "2ab2345c-67de-8901-f23g-45h678901j2k", "MemberType": "User", "Email": "zhangw@example.com", "FullName": "Zhang Wei", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45" }, "Role": "Member", "InvitedBy": "arn:aws:iam::111122223333:user/alejandro", "UpdatedTimestamp": "2019-12-02T22:46:58.532Z" }, { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Member": { "MemberId": "1ab2345c-67de-8901-f23g-45h678901j2k", "MemberType": "User", "Email": "janed@example.com", "FullName": "Jane Doe", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45" }, "Role": "Administrator", "InvitedBy": "arn:aws:iam::111122223333:user/alejandro", "UpdatedTimestamp": "2019-12-02T22:46:58.532Z" } ] }
For more information, see Creating a Chat Room
in the Amazon Chime User Guide. -
For API details, see ListRoomMemberships
in Amazon CLI Command Reference.
-
The following code example shows how to use list-rooms
.
- Amazon CLI
-
To list chat rooms
The following
list-rooms
example displays a list of chat rooms in the specified account. The list is filtered to only those chat rooms that the specified member belongs to.aws chime list-rooms \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --member-id1ab2345c-67de-8901-f23g-45h678901j2k
Output:
{ "Room": { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Name": "teamRoom", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45", "CreatedBy": "arn:aws:iam::111122223333:user/alejandro", "CreatedTimestamp": "2019-12-02T22:29:31.549Z", "UpdatedTimestamp": "2019-12-02T22:33:19.310Z" } }
For more information, see Creating a Chat Room
in the Amazon Chime User Guide. -
For API details, see ListRooms
in Amazon CLI Command Reference.
-
The following code example shows how to use list-users
.
- Amazon CLI
-
To list the users in an account
The following
list-users
example lists the users for the specified Amazon Chime account.aws chime list-users --account-id
a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
Output:
{ "Users": [ { "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "PrimaryEmail": "mariag@example.com", "DisplayName": "Maria Garcia", "LicenseType": "Pro", "UserType": "PrivateUser", "UserRegistrationStatus": "Registered", "RegisteredOn": "2018-12-20T18:45:25.231Z" "AlexaForBusinessMetadata": { "IsAlexaForBusinessEnabled": false } }, { "UserId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "PrimaryEmail": "richardr@example.com", "DisplayName": "Richard Roe", "LicenseType": "Pro", "UserType": "PrivateUser", "UserRegistrationStatus": "Registered", "RegisteredOn": "2018-12-20T18:45:45.415Z" "AlexaForBusinessMetadata": { "IsAlexaForBusinessEnabled": false } }, { "UserId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "PrimaryEmail": "saanvis@example.com", "DisplayName": "Saanvi Sarkar", "LicenseType": "Basic", "UserType": "PrivateUser", "UserRegistrationStatus": "Registered", "RegisteredOn": "2018-12-20T18:46:57.747Z" "AlexaForBusinessMetadata": { "IsAlexaForBusinessEnabled": false } }, { "UserId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "PrimaryEmail": "wxiulan@example.com", "DisplayName": "Wang Xiulan", "LicenseType": "Basic", "UserType": "PrivateUser", "UserRegistrationStatus": "Registered", "RegisteredOn": "2018-12-20T18:47:15.390Z" "AlexaForBusinessMetadata": { "IsAlexaForBusinessEnabled": false } } ] }
For more information, see Managing Users
in the Amazon Chime Administration Guide. -
For API details, see ListUsers
in Amazon CLI Command Reference.
-
The following code example shows how to use list-voice-connector-groups
.
- Amazon CLI
-
To list Amazon Chime Voice Connector groups for an Amazon Chime account
The following
list-voice-connector-groups
example lists the Amazon Chime Voice Connector groups associated with the administrator's Amazon Chime account.aws chime list-voice-connector-groups
Output:
{ "VoiceConnectorGroups": [ { "VoiceConnectorGroupId": "123a456b-c7d8-90e1-fg23-4h567jkl8901", "Name": "myGroup", "VoiceConnectorItems": [], "CreatedTimestamp": "2019-09-18T16:38:34.734Z", "UpdatedTimestamp": "2019-09-18T16:38:34.734Z" } ] }
For more information, see Working with Amazon Chime Voice Connector groups
in the Amazon Chime Administration Guide. -
For API details, see ListVoiceConnectorGroups
in Amazon CLI Command Reference.
-
The following code example shows how to use list-voice-connector-termination-credentials
.
- Amazon CLI
-
To retrieve a list of termination credentials
The following
list-voice-connector-termination-credentials
example retrieves a list of the termination credentials for the specified Amazon Chime Voice Connector.aws chime list-voice-connector-termination-credentials \ --voice-connector-id
abcdef1ghij2klmno3pqr4
This command produces no output. Output:
{ "Usernames": [ "jdoe" ] }
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see ListVoiceConnectorTerminationCredentials
in Amazon CLI Command Reference.
-
The following code example shows how to use list-voice-connectors
.
- Amazon CLI
-
To list Amazon Chime Voice Connectors for an account
The following
list-voice-connectors
example lists the Amazon Chime Voice Connectors associated with the caller's account.aws chime list-voice-connectors
Output:
{ "VoiceConnectors": [ { "VoiceConnectorId": "abcdef1ghij2klmno3pqr4", "AwsRegion": "us-east-1", "Name": "MyVoiceConnector", "OutboundHostName": "abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws", "RequireEncryption": true, "CreatedTimestamp": "2019-06-04T18:46:56.508Z", "UpdatedTimestamp": "2019-09-18T16:33:00.806Z" }, { "VoiceConnectorId": "cbadef1ghij2klmno3pqr5", "AwsRegion": "us-west-2", "Name": "newVoiceConnector", "OutboundHostName": "cbadef1ghij2klmno3pqr5.voiceconnector.chime.aws", "RequireEncryption": true, "CreatedTimestamp": "2019-09-18T20:34:01.352Z", "UpdatedTimestamp": "2019-09-18T20:34:01.352Z" } ] }
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see ListVoiceConnectors
in Amazon CLI Command Reference.
-
The following code example shows how to use logout-user
.
- Amazon CLI
-
To log out a user
The following
logout-user
example logs out the specified user.aws chime logout-user \ --account-id
a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
\ --user-ida1b2c3d4-5678-90ab-cdef-22222EXAMPLE
This command produces no output.
-
For API details, see LogoutUser
in Amazon CLI Command Reference.
-
The following code example shows how to use put-voice-connector-logging-configuration
.
- Amazon CLI
-
To add a logging configuration for an Amazon Chime Voice Connector
The following
put-voice-connector-logging-configuration
example turns on the SIP logging configuration for the specified Amazon Chime Voice Connector.aws chime put-voice-connector-logging-configuration \ --voice-connector-id
abcdef1ghij2klmno3pqr4
\ --logging-configurationEnableSIPLogs=true
Output:
{ "LoggingConfiguration": { "EnableSIPLogs": true } }
For more information, see Streaming Amazon Chime Voice Connector Media to Kinesis
in the Amazon Chime Administration Guide. -
For API details, see PutVoiceConnectorLoggingConfiguration
in Amazon CLI Command Reference.
-
The following code example shows how to use put-voice-connector-origination
.
- Amazon CLI
-
To set up origination settings
The following
put-voice-connector-origination
example sets up the origination host, port, protocol, priority, and weight for the specified Amazon Chime Voice Connector.aws chime put-voice-connector-origination \ --voice-connector-id
abcdef1ghij2klmno3pqr4
\ --origination Routes=[{Host="10.24.34.0",Port=1234,Protocol="TCP",Priority=1,Weight=5}],Disabled=falseOutput:
{ "Origination": { "Routes": [ { "Host": "10.24.34.0", "Port": 1234, "Protocol": "TCP", "Priority": 1, "Weight": 5 } ], "Disabled": false } }
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see PutVoiceConnectorOrigination
in Amazon CLI Command Reference.
-
The following code example shows how to use put-voice-connector-proxy
.
- Amazon CLI
-
To put a proxy configuration
The following
put-voice-connector-proxy
example sets a proxy configuration to your Amazon Chime Voice Connector.aws chime put-voice-connector-proxy \ --voice-connector-id
abcdef1ghij2klmno3pqr4
\ --default-session-expiry-minutes60
\ --phone-number-pool-countries"US"
Output:
{ "Proxy": { "DefaultSessionExpiryMinutes": 60, "Disabled": false, "PhoneNumberCountries": [ "US" ] } }
For more information, see Proxy Phone Sessions
in the Amazon Chime Developer Guide. -
For API details, see PutVoiceConnectorProxy
in Amazon CLI Command Reference.
-
The following code example shows how to use put-voice-connector-streaming-configuration
.
- Amazon CLI
-
To create a streaming configuration
The following
put-voice-connector-streaming-configuration
example creates a streaming configuration for the specified Amazon Chime Voice Connector. It enables media streaming from the Amazon Chime Voice Connector to Amazon Kinesis, and sets the data retention period to 24 hours.aws chime put-voice-connector-streaming-configuration \ --voice-connector-id
abcdef1ghij2klmno3pqr4
\ --streaming-configurationDataRetentionInHours=24,Disabled=false
Output:
{ "StreamingConfiguration": { "DataRetentionInHours": 24, "Disabled": false } }
For more information, see Streaming Amazon Chime Voice Connector Data to Kinesis
in the Amazon Chime Administration Guide. -
For API details, see PutVoiceConnectorStreamingConfiguration
in Amazon CLI Command Reference.
-
The following code example shows how to use put-voice-connector-termination-credentials
.
- Amazon CLI
-
To set up termination credentials
The following
put-voice-connector-termination-credentials
example sets termination credentials for the specified Amazon Chime Voice Connector.aws chime put-voice-connector-termination-credentials \ --voice-connector-id
abcdef1ghij2klmno3pqr4
\ --credentials Username="jdoe",Password="XXXXXXXX"This command produces no output.
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see PutVoiceConnectorTerminationCredentials
in Amazon CLI Command Reference.
-
The following code example shows how to use put-voice-connector-termination
.
- Amazon CLI
-
To set up termination settings
The following
put-voice-connector-termination
example sets the calling regions and allowed IP host termination settings for the specified Amazon Chime Voice Connector.aws chime put-voice-connector-termination \ --voice-connector-id
abcdef1ghij2klmno3pqr4
\ --termination CallingRegions="US",CidrAllowedList="10.24.34.0/23",Disabled=falseOutput:
{ "Termination": { "CpsLimit": 0, "CallingRegions": [ "US" ], "CidrAllowedList": [ "10.24.34.0/23" ], "Disabled": false } }
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see PutVoiceConnectorTermination
in Amazon CLI Command Reference.
-
The following code example shows how to use regenerate-security-token
.
- Amazon CLI
-
To regenerate a security token
The following
regenerate-security-token
example regenerates the security token for the specified bot.aws chime regenerate-security-token \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --bot-id123abcd4-5ef6-789g-0h12-34j56789012k
Output:
{ "Bot": { "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k", "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k", "DisplayName": "myBot (Bot)", "BotType": "ChatBot", "Disabled": false, "CreatedTimestamp": "2019-09-09T18:05:56.749Z", "UpdatedTimestamp": "2019-09-09T18:05:56.749Z", "BotEmail": "myBot-chimebot@example.com", "SecurityToken": "je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY" } }
For more information, see Authenticate Chat Bot Requests
in the Amazon Chime Developer Guide. -
For API details, see RegenerateSecurityToken
in Amazon CLI Command Reference.
-
The following code example shows how to use reset-personal-pin
.
- Amazon CLI
-
To reset a user's personal meeting PIN
The following
reset-personal-pin
example resets the specified user's personal meeting PIN.aws chime reset-personal-pin \ --account-id
a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
--user-ida1b2c3d4-5678-90ab-cdef-22222EXAMPLE
Output:
{ "User": { "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "PrimaryEmail": "mateo@example.com", "DisplayName": "Mateo Jackson", "LicenseType": "Pro", "UserType": "PrivateUser", "UserRegistrationStatus": "Registered", "RegisteredOn": "2018-12-20T18:45:25.231Z", "AlexaForBusinessMetadata": { "IsAlexaForBusinessEnabled": False, "AlexaForBusinessRoomArn": "null" }, "PersonalPIN": "XXXXXXXXXX" } }
For more information, see Changing Personal Meeting PINs
in the Amazon Chime Administration Guide. -
For API details, see ResetPersonalPin
in Amazon CLI Command Reference.
-
The following code example shows how to use restore-phone-number
.
- Amazon CLI
-
To restore a phone number
The following
restore-phone-number
example restores the specified phone number from the deletion queue.aws chime restore-phone-number \ --phone-number-id
"+12065550100"
Output:
{ "PhoneNumber": { "PhoneNumberId": "%2B12065550100", "E164PhoneNumber": "+12065550100", "Type": "Local", "ProductType": "BusinessCalling", "Status": "Unassigned", "Capabilities": { "InboundCall": true, "OutboundCall": true, "InboundSMS": true, "OutboundSMS": true, "InboundMMS": true, "OutboundMMS": true }, "Associations": [], "CreatedTimestamp": "2019-08-09T21:35:21.445Z", "UpdatedTimestamp": "2019-08-12T22:06:36.355Z" } }
For more information, see Working with Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see RestorePhoneNumber
in Amazon CLI Command Reference.
-
The following code example shows how to use search-available-phone-numbers
.
- Amazon CLI
-
To search available phone numbers
The following
search-available-phone-numbers
example searches available phone numbers by area code.aws chime search-available-phone-numbers \ --area-code
"206"
Output:
{ "E164PhoneNumbers": [ "+12065550100", "+12065550101", "+12065550102", "+12065550103", "+12065550104", "+12065550105", "+12065550106", "+12065550107", "+12065550108", "+12065550109", ] }
For more information, see Working with Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see SearchAvailablePhoneNumbers
in Amazon CLI Command Reference.
-
The following code example shows how to use update-account-settings
.
- Amazon CLI
-
To update the settings for your account
The following
update-account-settings
example disables the remote control of shared screens for the specified Amazon Chime account.aws chime update-account-settings \ --account-id
a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
\ --account-settingsDisableRemoteControl=true
This command produces no output.
-
For API details, see UpdateAccountSettings
in Amazon CLI Command Reference.
-
The following code example shows how to use update-account
.
- Amazon CLI
-
To update an account
The following
update-account
example updates the specified account name.aws chime update-account \ --account-id
a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
\ --nameMyAccountName
Output:
{ "Account": { "AwsAccountId": "111122223333", "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "Name": "MyAccountName", "AccountType": "Team", "CreatedTimestamp": "2018-09-04T21:44:22.292Z", "DefaultLicense": "Pro", "SupportedLicenses": [ "Basic", "Pro" ], "SigninDelegateGroups": [ { "GroupName": "myGroup" }, ] } }
For more information, see Renaming Your Account
in the Amazon Chime Administration Guide. -
For API details, see UpdateAccount
in Amazon CLI Command Reference.
-
The following code example shows how to use update-bot
.
- Amazon CLI
-
To update a bot
The following
update-bot
example updates the status of the specified bot to stop it from running.aws chime update-bot \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --bot-id123abcd4-5ef6-789g-0h12-34j56789012k
\ --disabledOutput:
{ "Bot": { "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k", "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k", "DisplayName": "myBot (Bot)", "BotType": "ChatBot", "Disabled": true, "CreatedTimestamp": "2019-09-09T18:05:56.749Z", "UpdatedTimestamp": "2019-09-09T18:05:56.749Z", "BotEmail": "myBot-chimebot@example.com", "SecurityToken": "je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY" } }
For more information, see Update Chat Bots
in the Amazon Chime Developer Guide. -
For API details, see UpdateBot
in Amazon CLI Command Reference.
-
The following code example shows how to use update-global-settings
.
- Amazon CLI
-
To update global settings
The following
update-global-settings
example updates the S3 bucket used to store call detail records for Amazon Chime Business Calling and Amazon Chime Voice Connectors associated with the administrator's Amazon account.aws chime update-global-settings \ --business-calling CdrBucket="s3bucket" \ --voice-connector CdrBucket="s3bucket"
This command produces no output.
For more information, see Managing Global Settings
in the Amazon Chime Administration Guide. -
For API details, see UpdateGlobalSettings
in Amazon CLI Command Reference.
-
The following code example shows how to use update-phone-number-settings
.
- Amazon CLI
-
To update an outbound calling name
The following
update-phone-number-settings
example updates the default outbound calling name for the administrator's Amazon account.aws chime update-phone-number-settings \ --calling-name
"myName"
This command produces no output.
For more information, see Working with Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see UpdatePhoneNumberSettings
in Amazon CLI Command Reference.
-
The following code example shows how to use update-phone-number
.
- Amazon CLI
-
Example 1: To update the product type for a phone number
The following
update-phone-number
example updates the specified phone number's product type.aws chime update-phone-number \ --phone-number-id
"+12065550100"
\ --product-type"BusinessCalling"
Output:
{ "PhoneNumber": { "PhoneNumberId": "%2B12065550100", "E164PhoneNumber": "+12065550100", "Type": "Local", "ProductType": "BusinessCalling", "Status": "Unassigned", "Capabilities": { "InboundCall": true, "OutboundCall": true, "InboundSMS": true, "OutboundSMS": true, "InboundMMS": true, "OutboundMMS": true }, "Associations": [], "CallingName": "phonenumber1", "CreatedTimestamp": "2019-08-09T21:35:21.445Z", "UpdatedTimestamp": "2019-08-12T21:44:07.591Z" } }
Example 2: To update the outbound calling name for a phone number
The following
update-phone-number
example updates the outbound calling name for the specified phone number.aws chime update-phone-number --phone-number-id "+12065550100" --calling-name "phonenumber2"
Output:
{ "PhoneNumber": { "PhoneNumberId": "%2B12065550100", "E164PhoneNumber": "+12065550100", "Type": "Local", "ProductType": "BusinessCalling", "Status": "Unassigned", "Capabilities": { "InboundCall": true, "OutboundCall": true, "InboundSMS": true, "OutboundSMS": true, "InboundMMS": true, "OutboundMMS": true }, "Associations": [], "CallingName": "phonenumber2", "CreatedTimestamp": "2019-08-09T21:35:21.445Z", "UpdatedTimestamp": "2019-08-12T21:44:07.591Z" } }
For more information, see Working with Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see UpdatePhoneNumber
in Amazon CLI Command Reference.
-
The following code example shows how to use update-proxy-session
.
- Amazon CLI
-
To update a proxy session
The following
update-proxy-session
example updates the proxy session capabilities.aws chime update-proxy-session \ --voice-connector-id
abcdef1ghij2klmno3pqr4
\ --proxy-session-id123a4bc5-67d8-901e-2f3g-h4ghjk56789l
\ --capabilities"Voice"
Output:
{ "ProxySession": { "VoiceConnectorId": "abcdef1ghij2klmno3pqr4", "ProxySessionId": "123a4bc5-67d8-901e-2f3g-h4ghjk56789l", "Status": "Open", "ExpiryMinutes": 60, "Capabilities": [ "Voice" ], "CreatedTimestamp": "2020-04-15T16:10:10.288Z", "UpdatedTimestamp": "2020-04-15T16:10:10.288Z", "Participants": [ { "PhoneNumber": "+12065550100", "ProxyPhoneNumber": "+19135550199" }, { "PhoneNumber": "+14015550101", "ProxyPhoneNumber": "+19135550199" } ] } }
For more information, see Proxy Phone Sessions
in the Amazon Chime Developer Guide. -
For API details, see UpdateProxySession
in Amazon CLI Command Reference.
-
The following code example shows how to use update-room-membership
.
- Amazon CLI
-
To update a room membership
The following
update-room-membership
example modifies the role of the specified chat room member toAdministrator
.aws chime update-room-membership \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --room-idabcd1e2d-3e45-6789-01f2-3g45h67i890j
\ --member-id1ab2345c-67de-8901-f23g-45h678901j2k
\ --roleAdministrator
Output:
{ "RoomMembership": { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Member": { "MemberId": "1ab2345c-67de-8901-f23g-45h678901j2k", "MemberType": "User", "Email": "sofiamartinez@example.com", "FullName": "Sofia Martinez", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45" }, "Role": "Administrator", "InvitedBy": "arn:aws:iam::111122223333:user/admin", "UpdatedTimestamp": "2019-12-02T22:40:22.931Z" } }
For more information, see Creating a Chat Room
in the Amazon Chime User Guide. -
For API details, see UpdateRoomMembership
in Amazon CLI Command Reference.
-
The following code example shows how to use update-room
.
- Amazon CLI
-
To update a chat room
The following
update-room
example modifies the name of the specified chat room.aws chime update-room \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --room-idabcd1e2d-3e45-6789-01f2-3g45h67i890j
\ --nameteamRoom
Output:
{ "Room": { "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j", "Name": "teamRoom", "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45", "CreatedBy": "arn:aws:iam::111122223333:user/alejandro", "CreatedTimestamp": "2019-12-02T22:29:31.549Z", "UpdatedTimestamp": "2019-12-02T22:33:19.310Z" } }
For more information, see Creating a Chat Room
in the Amazon Chime User Guide. -
For API details, see UpdateRoom
in Amazon CLI Command Reference.
-
The following code example shows how to use update-user-settings
.
- Amazon CLI
-
To update user settings
The following
update-user-settings
example enables the specified user to make inbound and outbound calls and send and receive SMS messages.aws chime update-user-settings \ --account-id
12a3456b-7c89-012d-3456-78901e23fg45
\ --user-id1ab2345c-67de-8901-f23g-45h678901j2k
\ --user-settings"Telephony={InboundCalling=true,OutboundCalling=true,SMS=true}"
This command produces no output.
For more information, see Managing User Phone Numbers
in the Amazon Chime Administration Guide. -
For API details, see UpdateUserSettings
in Amazon CLI Command Reference.
-
The following code example shows how to use update-user
.
- Amazon CLI
-
To update user details
This example updates the specified details for the specified user.
Command:
aws chime update-user \ --account-id
a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
\ --user-ida1b2c3d4-5678-90ab-cdef-22222EXAMPLE
\ --license-type"Basic"
Output:
{ "User": { "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" } }
-
For API details, see UpdateUser
in Amazon CLI Command Reference.
-
The following code example shows how to use update-voice-connector-group
.
- Amazon CLI
-
To update the details for an Amazon Chime Voice Connector group
The following
update-voice-connector-group
example updates the details of the specified Amazon Chime Voice Connector group.aws chime update-voice-connector-group \ --voice-connector-group-id
123a456b-c7d8-90e1-fg23-4h567jkl8901
\ --name"newGroupName"
\ --voice-connector-itemsVoiceConnectorId=abcdef1ghij2klmno3pqr4,Priority=1
Output:
{ "VoiceConnectorGroup": { "VoiceConnectorGroupId": "123a456b-c7d8-90e1-fg23-4h567jkl8901", "Name": "newGroupName", "VoiceConnectorItems": [ { "VoiceConnectorId": "abcdef1ghij2klmno3pqr4", "Priority": 1 } ], "CreatedTimestamp": "2019-09-18T16:38:34.734Z", "UpdatedTimestamp": "2019-10-28T19:00:57.081Z" } }
For more information, see Working with Amazon Chime Voice Connector Groups
in the Amazon Chime Administration Guide. -
For API details, see UpdateVoiceConnectorGroup
in Amazon CLI Command Reference.
-
The following code example shows how to use update-voice-connector
.
- Amazon CLI
-
To update the details for an Amazon Chime Voice Connector
The following
update-voice-connector
example updates the name of the specified Amazon Chime Voice Connector.aws chime update-voice-connector \ --voice-connector-id
abcdef1ghij2klmno3pqr4
\ --namenewName
\ --require-encryptionOutput:
{ "VoiceConnector": { "VoiceConnectorId": "abcdef1ghij2klmno3pqr4", "AwsRegion": "us-west-2", "Name": "newName", "OutboundHostName": "abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws", "RequireEncryption": true, "CreatedTimestamp": "2019-09-18T20:34:01.352Z", "UpdatedTimestamp": "2019-09-18T20:40:52.895Z" } }
For more information, see Working with Amazon Chime Voice Connectors
in the Amazon Chime Administration Guide. -
For API details, see UpdateVoiceConnector
in Amazon CLI Command Reference.
-