Esempi di utilizzo di Amazon Chime AWS CLI

Come associare un numero di telefono a un utente

L’esempio associate-phone-number-with-user seguente associa il numero di telefono specificato a un utente.

aws chime associate-phone-number-with-user \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --user-id 1ab2345c-67de-8901-f23g-45h678901j2k \
    --e164-phone-number "+12065550100"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Gestione dei numeri di telefono degli utenti nella Guida all’amministrazione di Amazon Chime.

Come associare gruppi di delegati di accesso

L’esempio associate-signin-delegate-groups-with-account seguente associa il gruppo di delegati di accesso specificato all’account Amazon Chime specificato.

aws chime associate-signin-delegate-groups-with-account \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --signin-delegate-groups GroupName=my_users

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Gestione dell’accesso e delle autorizzazioni degli utenti nella Guida all’amministrazione di Amazon Chime.

Come creare più appartenenze alla chat room

L’esempio batch-create-room-membership seguente aggiunge più utenti a una chat room come membri della chat room. Inoltre, assegna agli utenti i ruoli di amministratore e membro.

aws chime batch-create-room-membership \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-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": []
}

Per ulteriori informazioni, consulta Creazione di una chat room nella Guida per l’utente di Amazon Chime.

Come eliminare più numeri di telefono

L’esempio batch-delete-phone-number seguente elimina tutti i numeri di telefono specificati.

aws chime batch-delete-phone-number \
    --phone-number-ids "%2B12065550100" "%2B12065550101"

Questo comando non produce alcun output. Output:

{
    "PhoneNumberErrors": []
}

Per ulteriori informazioni, consulta Utilizzo dei numeri di telefono nella Guida di amministrazione di Amazon Chime.

Come sospendere più utenti

L’esempio batch-suspend-user seguente sospende gli utenti elencati dall’account Amazon Chime specificato.

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": []
}

Come annullare la sospensione di più utenti

L’esempio batch-unsuspend-user seguente rimuove qualsiasi sospensione precedente per gli utenti elencati dall’account Amazon Chime specificato.

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": []
}

Come aggiornare contemporaneamente più tipi di prodotto per i numeri di telefono

L’esempio batch-update-phone-number seguente aggiorna i tipi di prodotto per tutti i numeri di telefono specificati.

aws chime batch-update-phone-number \
    --update-phone-number-request-items PhoneNumberId=%2B12065550100,ProductType=BusinessCalling PhoneNumberId=%2B12065550101,ProductType=BusinessCalling

Output:

{
    "PhoneNumberErrors": []
}

Come aggiornare contemporaneamente più nomi di chiamanti di numeri di telefono

L’esempio batch-update-phone-number seguente aggiorna i nomi di chiamanti per tutti i numeri di telefono specificati.

aws chime batch-update-phone-number \
    --update-phone-number-request-items PhoneNumberId=%2B14013143874,CallingName=phonenumber1 PhoneNumberId=%2B14013144061,CallingName=phonenumber2

Output:

{
    "PhoneNumberErrors": []
}

Per ulteriori informazioni, consulta Utilizzo dei numeri di telefono nella Guida di amministrazione di Amazon Chime.

Come aggiornare più utenti con un singolo comando

L’esempio batch-update-user seguente aggiorna LicenseType per ciascuno degli utenti elencati nell’account Amazon Chime specificato.

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": []
}

Come creare un account

L'create-accountesempio seguente crea un account Amazon Chime con l'account dell'amministratore. AWS

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"
            },
        ]
    }
}

Per ulteriori informazioni, consulta Nozioni di base nella Guida di amministrazione di Amazon Chime.

Come creare un bot Amazon Chime

L’esempio create-bot seguente crea un bot per l’account Amazon Chime Enterprise specificato.

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"
    }
}

Per ulteriori informazioni, consulta Integrare un chat bot con Amazon Chime nella Guida per gli sviluppatori di Amazon Chime.

Come creare un ordine di numeri di telefono

L’esempio create-phone-number-order seguente crea un ordine di numeri di telefono per i numeri di telefono specificati.

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"
    }
}

Per ulteriori informazioni, consulta Utilizzo dei numeri di telefono nella Guida di amministrazione di Amazon Chime.

Come creare un’appartenenza a una chat room

L’esempio create-room-membership seguente aggiunge l’utente specificato alla chat room come membro della chat room.

aws chime create-room-membership \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j \
    --member-id 1ab2345c-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"
    }
}

Per ulteriori informazioni, consulta Creazione di una chat room nella Guida per l’utente di Amazon Chime.

Come creare una chat room

L’esempio create-room seguente crea una chat room per l’account Amazon Chime specificato.

aws chime create-room \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --name chatRoom

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"
    }
}

Per ulteriori informazioni, consulta Creazione di una chat room nella Guida per l’utente di Amazon Chime.

Come creare un profilo utente per un dispositivo condiviso

L’esempio create-user seguente crea un profilo di dispositivo condiviso per l’indirizzo e-mail specificato.

aws chime create-user \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --email roomdevice@example.com \
    --user-type SharedDevice

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
        }
    }
}

Per ulteriori informazioni, consulta Preparazione della configurazione nella Guida di amministrazione di Amazon Chime.

Come eliminare un account

L’esempio delete-account seguente elimina l’account specificato.

aws chime delete-account --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Eliminazione dell’account nella Guida di amministrazione di Amazon Chime.

Come eliminare un numero di telefono

L’esempio delete-phone-number seguente sposta il numero di telefono specificato nella coda di eliminazione.

aws chime delete-phone-number \
    --phone-number-id "+12065550100"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Utilizzo dei numeri di telefono nella Guida di amministrazione di Amazon Chime.

Come rimuovere un utente membro di una chat room

L’esempio delete-room-membership seguente rimuove il membro specificato dalla chat room specificata.

aws chime delete-room-membership \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j \
    --member-id 1ab2345c-67de-8901-f23g-45h678901j2k

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Creazione di una chat room nella Guida per l’utente di Amazon Chime.

Come eliminare una chat room

L’esempio delete-room seguente elimina la chat room specificata e rimuove le appartenenze alla chat room.

aws chime delete-room \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Creazione di una chat room nella Guida per l’utente di Amazon Chime.

Come annullare l’associazione di un numero di telefono a un utente

L’esempio disassociate-phone-number-from-user seguente annulla l’associazione di un numero di telefono all’utente specificato.

aws chime disassociate-phone-number-from-user \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --user-id 1ab2345c-67de-8901-f23g-45h678901j2k

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Gestione dei numeri di telefono degli utenti nella Guida all’amministrazione di Amazon Chime.

Come annullare l’associazione di gruppi di delegati di accesso

L’esempio disassociate-signin-delegate-groups-from-account seguente annulla l’associazione del gruppo di delegati di accesso specificato all’account Amazon Chime specificato.

aws chime disassociate-signin-delegate-groups-from-account \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --group-names "my_users"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Gestione dell’accesso e delle autorizzazioni degli utenti nella Guida all’amministrazione di Amazon Chime.

Come recuperare le impostazioni di un account

L’esempio get-account-settings seguente recupera le impostazioni dell’account specificato.

aws chime get-account-settings --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE

Output:

{
    "AccountSettings": {
        "DisableRemoteControl": false,
        "EnableDialOut": false
    }
}

Per ulteriori informazioni, consulta Gestione degli account Amazon Chime nella Guida di amministrazione di Amazon Chime.

Come recuperare i dettagli di un account

L’esempio get-account seguente recupera i dettagli dell’account Amazon Chime specificato.

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"
            },
        ]
    }
}

Per ulteriori informazioni, consulta Gestione degli account Amazon Chime nella Guida di amministrazione di Amazon Chime.

Come recuperare i dettagli su un bot

L’esempio get-bot seguente visualizza i dettagli del bot specificato.

aws chime get-bot \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --bot-id 123abcd4-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"
    }
}

Per ulteriori informazioni, consulta Aggiornare i chat bot nella Guida per gli sviluppatori di Amazon Chime.

Come ottenere le impostazioni globali

L'get-global-settingsesempio seguente recupera i nomi dei bucket S3 utilizzati per archiviare i record dei dettagli delle chiamate per Amazon Chime Business Calling e Amazon Chime Voice Connectors associati all'account dell'amministratore. AWS

aws chime get-global-settings

Output:

{
    "BusinessCalling": {
        "CdrBucket": "s3bucket"
    },
    "VoiceConnector": {
        "CdrBucket": "s3bucket"
    }
}

Per ulteriori informazioni, consulta Gestione delle impostazioni globali nella Guida di amministrazione di Amazon Chime.

Come ottenere i dettagli dell’ordine di numeri di telefono

L’esempio get-phone-number-order seguente visualizza i dettagli dell’ordine di numeri di telefono specificato.

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"
    }
}

Per ulteriori informazioni, consulta Utilizzo dei numeri di telefono nella Guida di amministrazione di Amazon Chime.

Come recuperare il nome di una chiamata in uscita

L'get-phone-number-settingsesempio seguente recupera il nome di chiamata in uscita predefinito per l'account dell'utente chiamante. AWS

aws chime get-phone-number-settings

Questo comando non produce alcun output. Output:

{
    "CallingName": "myName",
    "CallingNameUpdatedTimestamp": "2019-10-28T18:56:42.911Z"
}

Per ulteriori informazioni, consulta Utilizzo dei numeri di telefono nella Guida di amministrazione di Amazon Chime.

Come ottenere i dettagli del numero di telefono

L’esempio get-phone-number seguente visualizza i dettagli del numero di telefono specificato.

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"
    }
}

Per ulteriori informazioni, consulta Utilizzo dei numeri di telefono nella Guida di amministrazione di Amazon Chime.

Come ottenere i dettagli di una chat room

L’esempio get-room seguente visualizza i dettagli della chat room specificata.

aws chime get-room \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-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"
    }
}

Per ulteriori informazioni, consulta Creazione di una chat room nella Guida per l’utente di Amazon Chime.

Come recuperare le impostazioni dell’utente

L’esempio get-user-settings seguente visualizza le impostazioni dell’utente specificate.

aws chime get-user-settings \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --user-id 1ab2345c-67de-8901-f23g-45h678901j2k

Output:

{
    "UserSettings": {
        "Telephony": {
            "InboundCalling": true,
            "OutboundCalling": true,
            "SMS": true
        }
    }
}

Per ulteriori informazioni, consulta Gestione dei numeri di telefono degli utenti nella Guida all’amministrazione di Amazon Chime.

Come ottenere i dettagli di un utente

L’esempio get-user seguente recupera i dettagli dell’utente specificato.

aws chime get-user \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
    --user-id a1b2c3d4-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"
    }
}

Per ulteriori informazioni, consulta Gestione degli utenti nella Guida di amministrazione di Amazon Chime.

Come invitare gli utenti ad Amazon Chime

L’esempio invite-users seguente invia un’e-mail per invitare un utente nell’account Amazon Chime specificato.

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"
        }
    ]
}

Per ulteriori informazioni, consulta Invito e sospensione degli utenti nella Guida di amministrazione di Amazon Chime.

Come ottenere un elenco di account

L'list-accountsesempio seguente recupera un elenco degli account Amazon Chime nell'account dell'amministratore. AWS

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"
                },
            ]
        }
    ]
}

Per ulteriori informazioni, consulta Gestione degli account Amazon Chime nella Guida di amministrazione di Amazon Chime.

Come recuperare un elenco di bot

L’esempio list-bots seguente elenca i bot associati all’account Amazon Chime Enterprise specificato.

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"
    }
}

Per ulteriori informazioni, consulta Utilizzare chat bot con Amazon Chime nella Guida per gli sviluppatori di Amazon Chime.

Come elencare gli ordini di numeri di telefono

L’esempio list-phone-number-orders seguente elenca gli ordini di numeri di telefono associati all’account dell’amministratore Amazon Chime.

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"
        }
    ]
}

Per ulteriori informazioni, consulta Utilizzo dei numeri di telefono nella Guida di amministrazione di Amazon Chime.

Come elencare i numeri di telefono di un account Amazon Chime

L’esempio list-phone-numbers seguente elenca i numeri di telefono associati all’account Amazon Chime dell’amministratore.

aws chime list-phone-numbers

Questo comando non produce alcun 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"
        }
    ]
}

Per ulteriori informazioni, consulta Utilizzo dei numeri di telefono nella Guida di amministrazione di Amazon Chime.

Come elencare le appartenenze a una chat room

L’esempio list-room-memberships seguente visualizza un elenco dei dettagli di appartenenza alla chat room specificata.

aws chime list-room-memberships \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-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"
        }
    ]
}

Per ulteriori informazioni, consulta Creazione di una chat room nella Guida per l’utente di Amazon Chime.

Come elencare le chat room

L’esempio list-rooms seguente visualizza un elenco di chat room nell’account specificato. L’elenco viene filtrato solo in base alle chat room a cui appartiene il membro specificato.

aws chime list-rooms \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --member-id 1ab2345c-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"
    }
}

Per ulteriori informazioni, consulta Creazione di una chat room nella Guida per l’utente di Amazon Chime.

Come elencare gli utenti di un account

L’esempio list-users seguente elenca gli utenti dell’account Amazon Chime specificato.

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
            }
        }
    ]
}

Per ulteriori informazioni, consulta Gestione degli utenti nella Guida di amministrazione di Amazon Chime.

Come disconnettere un utente

L’esempio logout-user seguente disconnette l’utente specificato.

aws chime logout-user \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
    --user-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE

Questo comando non produce alcun output.

Come rigenerare un token di sicurezza

L’esempio regenerate-security-token seguente rigenera il token di sicurezza per il bot specificato.

aws chime regenerate-security-token \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --bot-id 123abcd4-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"
    }
}

Per ulteriori informazioni, consulta Autenticare le richieste dei chat bot nella Guida per gli sviluppatori di Amazon Chime.

Come reimpostare il PIN della riunione personale di un utente

L’esempio reset-personal-pin seguente reimposta il PIN della riunione personale dell’utente specificato.

aws chime reset-personal-pin \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
    --user-id a1b2c3d4-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"
    }
}

Per ulteriori informazioni, consulta Modifica dei PIN delle riunioni personali nella Guida di amministrazione di Amazon Chime.

Come ripristinare un numero di telefono

L’esempio restore-phone-number seguente ripristina il numero di telefono specificato dalla coda di eliminazione.

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"
    }
}

Per ulteriori informazioni, consulta Utilizzo dei numeri di telefono nella Guida di amministrazione di Amazon Chime.

Come cercare i numeri di telefono disponibili

L’esempio search-available-phone-numbers seguente cerca i numeri di telefono disponibili in base al prefisso.

aws chime search-available-phone-numbers \
    --area-code "206"

Output:

{
    "E164PhoneNumbers": [
        "+12065550100",
        "+12065550101",
        "+12065550102",
        "+12065550103",
        "+12065550104",
        "+12065550105",
        "+12065550106",
        "+12065550107",
        "+12065550108",
        "+12065550109",
    ]
}

Per ulteriori informazioni, consulta Utilizzo dei numeri di telefono nella Guida di amministrazione di Amazon Chime.

Come aggiornare le impostazioni dell’account

L’esempio update-account-settings seguente disabilita il controllo remoto delle schermate condivise per l’account Amazon Chime specificato.

aws chime update-account-settings \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
    --account-settings DisableRemoteControl=true

Questo comando non produce alcun output.

Come aggiornare un account

L’esempio update-account seguente aggiorna il nome dell’account specificato.

aws chime update-account \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
    --name MyAccountName

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"
            },
        ]
    }
}

Per ulteriori informazioni, consulta Rinominare l’account nella Guida di amministrazione di Amazon Chime.

Come aggiornare un bot

L’esempio update-bot seguente aggiorna lo stato del bot specificato per impedirne l’esecuzione.

aws chime update-bot \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --bot-id 123abcd4-5ef6-789g-0h12-34j56789012k \
    --disabled

Output:

{
    "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"
    }
}

Per ulteriori informazioni, consulta Aggiornare i chat bot nella Guida per gli sviluppatori di Amazon Chime.

Come aggiornare le impostazioni globali

L'update-global-settingsesempio seguente aggiorna il bucket S3 utilizzato per archiviare i record dei dettagli delle chiamate per Amazon Chime Business Calling e Amazon Chime Voice Connectors associati all'account dell'amministratore. AWS

aws chime update-global-settings \
    --business-calling CdrBucket="s3bucket" \
    --voice-connector CdrBucket="s3bucket"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Gestione delle impostazioni globali nella Guida di amministrazione di Amazon Chime.

Come aggiornare il nome di una chiamata in uscita

L'update-phone-number-settingsesempio seguente aggiorna il nome di chiamata in uscita predefinito per l'account dell'amministratore. AWS

aws chime update-phone-number-settings \
    --calling-name "myName"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Utilizzo dei numeri di telefono nella Guida di amministrazione di Amazon Chime.

Esempio 1: come aggiornare il tipo di prodotto per un numero di telefono

L’esempio update-phone-number seguente aggiorna il tipo di prodotto del numero di telefono specificato.

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"
    }
}

Esempio 2: come aggiornare il nome della chiamata in uscita per un numero di telefono

L’esempio update-phone-number seguente aggiorna il nome della chiamata in uscita per il numero di telefono specificato.

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"
    }
}

Per ulteriori informazioni, consulta Utilizzo dei numeri di telefono nella Guida di amministrazione di Amazon Chime.

Come aggiornare un’appartenenza a una chat room

L’esempio update-room-membership seguente modifica il ruolo del membro della chat room specificato in Administrator.

aws chime update-room-membership \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j \
    --member-id 1ab2345c-67de-8901-f23g-45h678901j2k \
    --role Administrator

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"
    }
}

Per ulteriori informazioni, consulta Creazione di una chat room nella Guida per l’utente di Amazon Chime.

Come aggiornare una chat room

L’esempio update-room seguente modifica il nome della chat room specificata.

aws chime update-room \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j \
    --name teamRoom

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"
    }
}

Per ulteriori informazioni, consulta Creazione di una chat room nella Guida per l’utente di Amazon Chime.

Come aggiornare le impostazioni dell’utente

L’esempio update-user-settings seguente consente all’utente specificato di effettuare chiamate in entrata e in uscita e inviare e ricevere messaggi SMS.

aws chime update-user-settings \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --user-id 1ab2345c-67de-8901-f23g-45h678901j2k \
    --user-settings "Telephony={InboundCalling=true,OutboundCalling=true,SMS=true}"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Gestione dei numeri di telefono degli utenti nella Guida all’amministrazione di Amazon Chime.

Come aggiornare i dettagli dell’utente

Questo esempio aggiorna i dettagli specificati dell’utente specificato.

Comando:

aws chime update-user \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
    --user-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE \
    --license-type "Basic"

Output:

{
    "User": {
        "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE"
    }
}