翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Chime SDK メッセージングでのメッセージングデータのストリーミング
<a name="streaming-export"></a>

メッセージおよびチャネルイベントなどのデータをストリーム形式で受信するように `AppInstance` を設定できます。その後、そのデータにリアルタイムで対応することができます。現在、Amazon Chime SDK メッセージングは Kinesis ストリームのみをストリームの送信先として受け付けています。この機能で Kinesis ストリームを使用するには、以下の前提条件を満たす必要があります。
+ Kinesis ストリームは、 と同じ AWS アカウントにある必要があります`AppInstance`。
+ ストリームは `AppInstance` と同じリージョンに存在する必要があります。
+ ストリーム名には `chime-messaging-` で始まるプレフィックスが付きます。
+ 少なくとも 2 つのシャードを設定する必要があります。各シャードは 1 秒あたり最大 1 MB のデータを受信できるため、それに応じてストリームをスケールしてください。
+ サーバー側の暗号化 (SSE) を有効にします。

**Kinesis ストリームを設定するには**

1. 前のセクションの前提条件を使用して 1 つ以上の Kinesis ストリームを作成し、ARN を取得します。呼び出し元が Amazon Chime のアクセス許可に加えて Kinesis のアクセス許可を持っていることを確認してください。

   次の例は、 CLI AWS を使用して 2 つのシャードを持つ Kinesis ストリームを作成する方法と、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. [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) API を呼び出してストリーミングを設定します。

   2 つのデータタイプの一方または両方を設定でき、同じストリームまたは別々のストリームを選択できます。

   次の例は、 CLI AWS を使用して `ChannelMessage`および `Channel` データ型をストリーミング`appinstance`するように を設定する方法を示しています。

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

   データタイプには以下のスコープがあります。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/chime-sdk/latest/dg/streaming-export.html)

1. 設定した Kinesis ストリームからデータの読み取りを開始します。
**注記**  
ストリーミングを設定する前に送信されたイベントは、Kinesis ストリームには送信されません。

**[Data format] (データ形式)**  
Kinesis は、`EventType` および `Payload` のフィールドを含む JSON 形式のレコードを出力します。ペイロード形式は `EventType` によって異なります。以下の表は、イベントタイプおよびそれに対応するペイロード形式を示しています。


<table>
<thead>
  <tr><th>EventType</th><th>ペイロード形式</th><th></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><td></td></tr>
  <tr><td>`REDACT_CHANNEL_MESSAGE`</td><td></td></tr>
  <tr><td>`UPDATE_CHANNEL_MESSAGE`</td><td></td></tr>
  <tr><td>`DELETE_CHANNEL_MESSAGE`</td><td></td></tr>
  <tr><td></td><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><td></td></tr>
  <tr><td>`UPDATE_CHANNEL`</td><td></td></tr>
  <tr><td>`DELETE_CHANNEL`</td><td></td></tr>
  <tr><td>`UPDATE_CHANNEL_EXPIRATION_SETTINGS`</td><td></td></tr>
  <tr><td></td><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><td></td></tr>
  <tr><td>`DELETE_CHANNEL_MEMBERSHIP`</td><td></td></tr>
  <tr><td></td><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><td></td></tr>
  <tr><td>`DELETE_CHANNEL_BAN`</td><td></td></tr>
  <tr><td></td><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><td></td></tr>
  <tr><td>`DELETE_CHANNEL_MODERATOR`</td><td></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><td></td></tr>
  <tr><td>`DELETE_SUB_CHANNEL`</td><td></td></tr>
</tbody>
</table>