创建 IVS 聊天室的 CLI 说明 - Amazon IVS
创建聊天室设置日志记录配置（可选）

创建 IVS 聊天室的 CLI 说明

本文档将引导您完成使用 AWS CLI 创建 Amazon IVS 聊天室所涉及的步骤。

创建聊天室

使用 Amazon CLI 创建聊天室是一个高级选项，需要先在计算机上下载并配置 CLI。有关详细信息，请参阅 Amazon 命令行界面用户指南。

  1. 运行聊天 create-room 命令并传入一个可选名称：

    aws ivschat create-room --name test-room

  2. 这将返回一个新的聊天室：

    {  
   "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. 请注意 arn 字段。您需要它来创建客户端令牌并连接到聊天室。

设置日志记录配置（可选）

与创建聊天室一样，使用 Amazon CLI 设置日志记录配置是一个高级选项，需要先在计算机上下载并配置 CLI。有关详细信息，请参阅 Amazon 命令行界面用户指南。

  1. 运行聊天 create-logging-configuration 命令并传入可选名称和按名称指向 Amazon S3 存储桶的目标配置。在创建日志记录配置之前，此 Amazon S3 存储桶必须存在。（有关创建 Amazon S3 存储桶的详细信息，请参阅 Amazon S3 文档。）

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

  2. 这将返回一个新的日志记录配置：

    {
   "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. 请注意 arn 字段。您需要此字段来将日志记录配置附加到聊天室。

    1. 如果您要创建新的聊天室，请运行 create-room 命令并传递日志记录配置 arn：

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

    2. 如果您要更新现有的聊天室，请运行 update-room 命令并传递日志记录配置 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"