Diffusion de données de messagerie

Vous pouvez configurer un AppInstance pour recevoir des données, telles que des messages et des événements de canal, sous la forme d'un flux. Vous pouvez ensuite réagir à ces données en temps réel. Actuellement, la messagerie du SDK Amazon Chime n'accepte que les flux Kinesis comme destinations de flux. Pour utiliser les flux Kinesis avec cette fonctionnalité, vous devez remplir les conditions suivantes :

• Les flux Kinesis doivent être enregistrés sur le même AWS compte que le. AppInstance

• Un flux doit se trouver dans la même région que leAppInstance.

• Les noms de flux ont un préfixe qui commence chime-messaging- par.

• Vous devez configurer au moins deux partitions. Chaque partition peut recevoir des données jusqu'à 1 Mo par seconde, alors adaptez votre flux en conséquence.

• Vous devez activer le chiffrement côté serveur (SSE).

Pour configurer un flux Kinesis

1. Créez un ou plusieurs flux Kinesis à l'aide des prérequis décrits dans la section précédente, puis obtenez l'ARN. Assurez-vous que l'appelant dispose des autorisations Kinesis en plus des autorisations Amazon Chime.

   Les exemples suivants montrent comment utiliser la AWS CLI pour créer un flux Kinesis avec deux partitions et comment activer SSE.

   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. Configurez le streaming en appelant l'PutMessagingStreamingConfigurationsAPI.

   Vous pouvez configurer l'un des deux types de données ou les deux, et vous pouvez choisir le même flux ou des flux distincts pour eux.

   Les exemples suivants montrent comment utiliser la AWS CLI pour configurer et appinstance diffuser les types de Channel données ChannelMessage et.

   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

   Les types de données ont les champs d'application suivants :

   DataType	Types d'événements générés
   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. Commencez à lire les données de votre flux Kinesis configuré.

   Note

   Les événements envoyés avant de configurer le streaming ne sont pas envoyés vers votre flux Kinesis.

Format de données

Kinesis génère des enregistrements au format JSON avec les champs suivants : EventType et. Payload Le format de charge utile dépend duEventType. Le tableau suivant répertorie les types d'événements et les formats de charge utile correspondants.

EventType	Format de charge utile
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