# Istruzioni della CLI per la creazione di una chat room IVS
<a name="create-room-cli"></a>

Questo documento illustra i passaggi necessari per creare una Chat room Amazon IVS utilizzando AWS CLI.

## Creazione di una chat room
<a name="create-room-cli-chat-room"></a>

La creazione di una chat room con la AWS CLI è un'opzione avanzata e richiede prima il download e la configurazione della CLI sul computer. Per maggiori dettagli, consultare la [Guida per l'utente dell'interfaccia a riga di comando di AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).

1. Eseguire il comando `create-room` della chat e inviare un nome facoltativo:

   ```
   aws ivschat create-room --name test-room
   ```

1. Viene restituita una nuova chat room:

   ```
   {  
      "arn": "arn:aws:ivschat:us-west-2:123456789012:room/g1H2I3j4k5L6",
      "id": "string",
      "createTime": "2021-06-07T14:26:05-07:00",
      "maximumMessageLength": 200, 
      "maximumMessageRatePerSecond": 10,
      "name": "test-room",
      "tags": {},
      "updateTime": "2021-06-07T14:26:05-07:00"
   }
   ```

1. Annotare il campo `arn`. Si avrà bisogno di questo campo per creare un token client e connettersi a una chat room.

## Impostazione di una configurazione di registrazione (facoltativo)
<a name="create-room-cli-logging"></a>

Come per la creazione di una chat room, l'impostazione di una configurazione di registrazione con AWS CLI è un'opzione avanzata e richiede prima il download e la configurazione della CLI sul computer. Per maggiori dettagli, consultare la [Guida per l'utente dell'interfaccia a riga di comando di AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).

1. Esegui il comando `create-logging-configuration` della chat e inserisci un nome facoltativo e una configurazione di destinazione che rimandi a un bucket Amazon S3 per nome. Questo bucket Amazon S3 deve già essere presente prima di creare la configurazione di registrazione. (Per i dettagli sulla creazione di un bucket Amazon S3, consulta la [documentazione di Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)).

   ```
   aws ivschat create-logging-configuration \
      --destination-configuration s3={bucketName=demo-logging-bucket} \
      --name "test-logging-config"
   ```

1. Viene restituita una nuova configurazione di registrazione:

   ```
   {
      "Arn": "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ",
      "createTime": "2022-09-14T17:48:00.653000+00:00",
      "destinationConfiguration": { 
         "s3": {"bucketName": "demo-logging-bucket"}
      },
      "id": "ABcdef34ghIJ",
      "name": "test-logging-config",
      "state": "ACTIVE",
      "tags": {},
      "updateTime": "2022-09-14T17:48:01.104000+00:00"
   }
   ```

1. Annotare il campo `arn`. Questa operazione è necessaria per allegare la configurazione di registrazione alla chat room.

   1. Se stai creando una nuova chat room, esegui il comando `create-room` e passa la configurazione di registrazione `arn`:

      ```
      aws ivschat create-room --name test-room \ 
      --logging-configuration-identifiers \
      "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ"
      ```

   1. Se stai aggiornando una chat room esistente, esegui il comando `update-room` e passa la configurazione di registrazione `arn`:

      ```
      aws ivschat update-room --identifier \
      "arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6" \
      --logging-configuration-identifiers \
      "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ"
      ```