

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Fazer streaming de dados do sistema de mensagens no SDK do Amazon Chime
<a name="streaming-export"></a>

Pode-se configurar um `AppInstance` para receber dados, como mensagens e eventos do canal, na forma de um stream. Você pode então reagir a esses dados em tempo real. Atualmente, o sistema de mensagens do SDK do Amazon Chime aceita somente fluxos do Kinesis como destinos de fluxos. Você deve ter esses pré-requisitos para usar Fluxos do Kinesis com esse atributo:
+ Os streams do Kinesis devem estar na mesma AWS conta do. `AppInstance`
+ O fluxo deve estar na mesma região da `AppInstance`.
+ Os nomes dos streams têm um prefixo que começam com `chime-messaging-`.
+ Você deve configurar pelo menos dois fragmentos. Cada fragmento pode receber até 1 MB de dados por segundo, então dimensione seu stream adequadamente.
+ Você deve habilitar a criptografia do lado do servidor (SSE).

**Para configurar um stream do Kinesis**

1. Crie um ou mais streams do Kinesis usando os pré-requisitos da seção anterior e, em seguida, obtenha o ARN. O chamador deve ter permissões do Kinesis, além das permissões do Amazon Chime.

   Os exemplos a seguir mostram como usar a AWS CLI para criar um stream do Kinesis com dois fragmentos e como habilitar o 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"`

1. Configure o streaming chamando a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_PutMessagingStreamingConfigurations.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_PutMessagingStreamingConfigurations.html).

   Você pode configurar um ou os dois tipos de dados e escolher o mesmo stream ou streams separados para eles.

   Os exemplos a seguir mostram como usar a AWS CLI para configurar e `appinstance` transmitir os tipos de `Channel` dados `ChannelMessage` e.

   ```
   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}}
   ```

   Os tipos de dados têm os seguintes escopos:    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/streaming-export.html)

1. Comece a ler os dados do seu stream do Kinesis configurado.
**nota**  
Todos os eventos enviados antes de você configurar o streaming não são enviados para seu stream do Kinesis.

**Formato de dados**  
O Kinesis gera registros no formato JSON com os seguintes campos: `EventType` e `Payload`. O formato da carga útil depende do `EventType`. A tabela a seguir lista os tipos de evento e seus formatos de carga correspondentes.


<table>
<thead>
  <tr><th>EventType</th><th>Formato da carga</th></tr>
</thead>
<tbody>
  <tr><td>`CREATE_CHANNEL_MESSAGE`</td><td rowspan="4"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMessage.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMessage.html) </td></tr>
  <tr><td>`REDACT_CHANNEL_MESSAGE`</td></tr>
  <tr><td>`UPDATE_CHANNEL_MESSAGE`</td></tr>
  <tr><td>`DELETE_CHANNEL_MESSAGE`</td></tr>
  <tr><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL`</td><td rowspan="4"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_Channel.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_Channel.html) </td></tr>
  <tr><td>`UPDATE_CHANNEL`</td></tr>
  <tr><td>`DELETE_CHANNEL`</td></tr>
  <tr><td>`UPDATE_CHANNEL_EXPIRATION_SETTINGS`</td></tr>
  <tr><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL_MEMBERSHIP`</td><td rowspan="2"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMembership.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMembership.html) </td></tr>
  <tr><td>`DELETE_CHANNEL_MEMBERSHIP`</td></tr>
  <tr><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL_BAN`</td><td rowspan="2"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelBan.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelBan.html) </td></tr>
  <tr><td>`DELETE_CHANNEL_BAN`</td></tr>
  <tr><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL_MODERATOR`</td><td rowspan="2"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelModerator.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelModerator.html) </td></tr>
  <tr><td>`DELETE_CHANNEL_MODERATOR`</td></tr>
  <tr><td>`CREATE_SUB_CHANNEL`</td><td rowspan="2">[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListSubChannels.html#API_messaging-chime_ListSubChannels_RequestSyntax](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListSubChannels.html#API_messaging-chime_ListSubChannels_RequestSyntax)<br />[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SubChannelSummary.html#chimesdk-Type-messaging-chime_SubChannelSummary-SubChannelId](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SubChannelSummary.html#chimesdk-Type-messaging-chime_SubChannelSummary-SubChannelId)</td></tr>
  <tr><td>`DELETE_SUB_CHANNEL`</td></tr>
</tbody>
</table>
