Messaging-Daten streamen

Sie können ein so konfigurieren, AppInstance dass es Daten wie Nachrichten und Kanalereignisse in Form eines Streams empfängt. Sie können dann in Echtzeit auf diese Daten reagieren. Derzeit akzeptiert Amazon Chime SDK-Messaging nur Kinesis-Streams als Stream-Ziele. Sie müssen die folgenden Voraussetzungen erfüllen, um Kinesis-Streams mit dieser Funktion verwenden zu können:

• Kinesis-Streams müssen sich im selben AWS Konto befinden wie dieAppInstance.

• Ein Stream muss sich in derselben Region befinden wie derAppInstance.

• Stream-Namen haben ein Präfix, das mit beginntchime-messaging-.

• Sie müssen mindestens zwei Shards konfigurieren. Jeder Shard kann Daten bis zu 1 MB pro Sekunde empfangen. Skalieren Sie Ihren Stream also entsprechend.

• Sie müssen die serverseitige Verschlüsselung (SSE) aktivieren.

So konfigurieren Sie einen Kinesis-Stream

1. Erstellen Sie einen oder mehrere Kinesis-Streams unter Verwendung der Voraussetzungen im vorherigen Abschnitt und rufen Sie dann den ARN ab. Stellen Sie sicher, dass der Anrufer zusätzlich zu den Amazon Chime Chime-Berechtigungen auch über Kinesis-Berechtigungen verfügt.

   Die folgenden Beispiele zeigen, wie Sie mit der AWS CLI einen Kinesis-Stream mit zwei Shards erstellen und SSE aktivieren.

   aws kinesis create-stream --stream-name chime-messaging-unique-name --shard-count 2

   aws kinesis start-stream-encryption --stream-name chime-messaging-unique-name --encryption-type KMS --key-id "alias/aws/kinesis"

2. Konfigurieren Sie das Streaming, indem Sie die PutMessagingStreamingConfigurationsAPI aufrufen.

   Sie können einen oder beide von zwei Datentypen konfigurieren und für sie denselben Stream oder separate Streams auswählen.

   Die folgenden Beispiele zeigen, wie Sie die AWS CLI verwenden, um die Channel Datentypen appinstance zu konfigurieren ChannelMessage und zu streamen.

   aws chime-sdk-messaging put-messaging-streaming-configurations --app-instance-arn app_instance_arn \
   --streaming-configurations DataType=ChannelMessage,ResourceArn=kinesis_data_stream_arn

   aws chime-sdk-messaging put-messaging-streaming-configurations --app-instance-arn app_instance_arn \
   --streaming-configurations DataType=Channel,ResourceArn=kinesis_data_stream_arn

   Die Datentypen haben die folgenden Bereiche:

   DataType	Generierte Ereignistypen
   ChannelMessage	CREATE_CHANNEL_MESSAGE
   	REDACT_CHANNEL_MESSAGE
   	UPDATE_CHANNEL_MESSAGE
   	DELETE_CHANNEL_MESSAGE
   Channel	CREATE_CHANNEL
   	CREATE_SUB_CHANNEL
   	UPDATE_CHANNEL
   	DELETE_CHANNEL
   	UPDATE_CHANNEL_EXPIRATION_SETTINGS
   	DELETE_SUB_CHANNEL
   	CREATE_CHANNEL_MEMBERSHIP
   	DELETE_CHANNEL_MEMBERSHIP
   	CREATE_CHANNEL_BAN
   	DELETE_CHANNEL_BAN
   	CREATE_CHANNEL_MODERATOR
   	DELETE_CHANNEL_MODERATOR

3. Beginnen Sie mit dem Lesen der Daten aus Ihrem konfigurierten Kinesis-Stream.

   Anmerkung

   Ereignisse, die vor der Streaming-Konfiguration gesendet wurden, werden nicht an Ihren Kinesis-Stream gesendet.

Data format (Datenformat)

Kinesis gibt Datensätze im JSON-Format mit den folgenden Feldern aus: EventType undPayload. Das Payload-Format hängt von der ab. EventType In der folgenden Tabelle sind die Ereignistypen und ihre entsprechenden Payload-Formate aufgeführt.

EventType	Payload-Format
CREATE_CHANNEL_MESSAGE	Channel message
REDACT_CHANNEL_MESSAGE
UPDATE_CHANNEL_MESSAGE
DELETE_CHANNEL_MESSAGE
CREATE_CHANNEL	Channel
UPDATE_CHANNEL
DELETE_CHANNEL
UPDATE_CHANNEL_EXPIRATION_SETTINGS
CREATE_CHANNEL_MEMBERSHIP	ChannelMembership
DELETE_CHANNEL_MEMBERSHIP
CREATE_CHANNEL_BAN	ChannelBan
DELETE_CHANNEL_BAN
CREATE_CHANNEL_MODERATOR	ChannelModerator
DELETE_CHANNEL_MODERATOR
CREATE_SUB_CHANNEL	channelARN SubChannelId
DELETE_SUB_CHANNEL