CLI-Anweisungen zum Erstellen eines IVS-Chatrooms

Dieses Dokument führt Sie durch die Schritte zur Integration des Amazon-IVS-Chatrooms mit der AWS CLI.

Erstellen eines Chatrooms

Das Erstellen eines Chatrooms mit der AWS CLI ist eine erweiterte Option und erfordert, dass Sie zuerst die CLI auf Ihrem Computer herunterladen und konfigurieren. Informationen zu den ersten Schritten finden Sie im Benutzerhandbuch für die AWS-Befehlszeilenschnittstelle.

1. Führen Sie den Chat-create-room-Befehl aus und und übergeben Sie einen optionalen Namen:

   aws ivschat create-room --name test-room

2. Dies gibt einen neuen Chatroom zurück:

   {  
      "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. Beachten Sie das Feld arn. Sie benötigen dies, um ein Client-Token zu erstellen und eine Verbindung mit einem Chatroom herzustellen.

Einrichten einer Protokollierungskonfiguration (optional)

Das Erstellen eines Chatrooms mit der AWS-CLI ist eine erweiterte Option. Dazu müssen Sie zunächst die CLI auf Ihrem Computer herunterladen und konfigurieren. Informationen zu den ersten Schritten finden Sie im Benutzerhandbuch für die AWS-Befehlszeilenschnittstelle.

1. Führen Sie den Chatbefehl create-logging-configuration aus und übergeben Sie einen optionalen Namen und eine Zielkonfiguration, die auf einen Amazon-S3-Bucket verweisen. Dieser Amazon-S3-Bucket muss vor Erstellung der Protokollierungskonfiguration vorhanden sein. (Einzelheiten zum Erstellen eines Amazon-S3-Buckets finden Sie in der Dokumentation zu Amazon S3.)

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

2. Hierdurch wird eine neue Protokollierungskonfiguration zurückgegeben:

   {
      "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. Beachten Sie das Feld arn. Dieses wird benötigt, um die Protokollierungskonfiguration an den Chatroom anzufügen.

   1. Wenn Sie einen neuen Chatroom erstellen, führen Sie den Befehl create-room aus und übergeben Sie die Protokollierungskonfiguration arn:

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

   2. Wenn Sie einen vorhandenen Chatroom aktualisieren, führen Sie den Befehl update-room aus und übergeben Sie die Protokollierungskonfiguration 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"