Instruções da CLI para criar uma sala de chat do IVS - Amazon IVS

Instruções da CLI para criar uma sala de chat do IVS

Este documento orienta você pelas etapas envolvidas na criação de uma sala de Chat do Amazon IVS usando a AWS CLI.

Criar uma sala de chat

A criação de uma sala de chat com a AWS CLI é uma opção avançada e exige que você baixe e configure a CLI em sua máquina primeiro. Para obter mais detalhes, consulte o Guia do usuário da Interface de Linhas de Comando da AWS.

  1. Execute o comando create-room e envie um nome opcional:

    aws ivschat create-room --name test-room
  2. Isso retorna uma nova sala de chat:

    { "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. Observe o campo arn. Você precisará dele para criar um token de cliente e se conectar a uma sala de chat.

Definição de uma configuração de log (opcional)

Assim como na criação de uma sala de chat, a definição de uma configuração de log com a AWS CLI é uma opção avançada e exige que você baixe e configure a CLI em sua máquina primeiro. Para obter mais detalhes, consulte o Guia do usuário da Interface de Linhas de Comando da AWS.

  1. Execute o comando create-logging-configuration de chat e insira um nome opcional e uma configuração de destino apontando para um bucket do Amazon S3 pelo nome. Esse bucket do Amazon S3 deve existir antes da criação da configuração de log. (Para obter detalhes sobre como criar um bucket do Amazon S3, consulte a Documentação do Amazon S3.)

    aws ivschat create-logging-configuration \ --destination-configuration s3={bucketName=demo-logging-bucket} \ --name "test-logging-config"
  2. Isso retornará uma nova configuração de log:

    { "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. Observe o campo arn. Você precisará disso para anexar a configuração de log à sala de chat.

    1. Se você estiver criando uma nova sala de chat, execute o comando create-room e passe a configuração de log arn:

      aws ivschat create-room --name test-room \ --logging-configuration-identifiers \ "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ"
    2. Se você estiver atualizando uma sala de chat existente, execute o comando update-room e passe a configuração de log 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"