Istruzioni della CLI per la creazione di una chat room IVS

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

Creazione di una chat room

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.

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

   aws ivschat create-room --name test-room

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

3. 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)

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.

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

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

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

3. 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"

   2. 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"