翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Chime SDK Messaging 名前空間への移行
Amazon Chime SDK Messaging 名前空間は、Amazon Chime SDK メッセージングリソースを作成および管理する API のための専用の場所です。名前空間を使用して、Amazon Chime SDK メッセージング API エンドポイントが利用可能な任意の AWS リージョンのエンドポイントに対処します。Amazon Chime SDK を使い始めたばかりの場合は、この名前空間を使用してください。リージョンの詳細については、このガイドの「利用できるリージョン」を参照してください。
Amazon Chime 名前空間を使用する既存のアプリケーションでは、専用の名前空間への移行を計画する必要があります。
移行すべき理由
以下の理由から、Amazon Chime SDK Messaging 名前空間に移行することをお勧めします。
- API エンドポイントの選択
Amazon Chime SDK Messaging 名前空間は、 を利用できる任意のリージョンで API エンドポイントを使用できる唯一の API 名前空間です。米国東部 (バージニア北部) 以外の API エンドポイントを使用する場合は、Amazon Chime SDK Messaging 名前空間を使用する必要があります。
Amazon Chime SDK メッセージングが AWS リージョンを使用する方法の詳細については、このガイドの「利用可能なリージョン」を参照してください。
- メッセージング API の更新と新規追加
Amazon Chime SDK Messaging 名前空間のメッセージング API のみを追加または更新します。
移行する前に
移行する前に、名前空間の相違点に注意してください｡ 以下の表では、名前空間の一覧と説明を示しています。
| Amazon Chime SDK Messaging 名前空間 | Amazon Chime 名前空間 | |
|---|---|---|
| AWS SDK 名前空間 | ChimeSDKMessaging | Chime |
| リージョン | 複数 | 米国東部 (バージニア北部) のみ |
| API | メッセージング用の API のみ | メッセージング用の API と Amazon Chime のその他の部分 |
| フロー | 利用可能 | 利用不可 |
| Elastic チャネル | 利用可能 | 利用不可 |
名前空間の相違点
以下のセクションでは、Amazon Chime 名前空間と Amazon Chime SDK Messaging 名前空間の相違点について説明します。
AWS SDK 名前空間
Amazon Chime SDK 名前空間では Chime という正式名を使用します。Amazon Chime SDK Messaging 名前空間では ChimeSDKMessaging という正式名を使用します。名前の正確な形式はプラットフォームによって異なります。
例えば、Node.js の AWS SDK を使用してメッセージングを作成する場合は、コード行を使用して名前空間に対処します。
const chimeMessaging = AWS.Chime();
Amazon Chime Messaging SDK に移行するには、このコード行を新しい名前空間とエンドポイントリージョンで更新します。
const chimeMessaging = AWS.ChimeSDKMessaging({ region: "Europe (Frankfurt)" });
リージョン
Amazon Chime 名前空間は、US East (N. Virginia) リージョンの API エンドポイントのみをアドレス指定します。Amazon Chime SDK Messaging 名前空間は、利用可能な任意のリージョンで Amazon Chime SDK メッセージング API エンドポイントをアドレス指定できます。メッセージングリージョンの最新リストについては、本ガイドの「利用できるリージョン」を参照してください。
エンドポイント
Amazon Chime SDK Messaging 名前空間は、Amazon Chime 名前空間とは異なる API エンドポイントを使用します。
メッセージングリソースを変更するために使用できるのは、メッセージングリソースの作成に使用したエンドポイントだけです。つまり、Europe (Frankfurt) のエンドポイントを介して作成されたメッセージングリソースは、Europe (Frankfurt) 経由でしか変更できないということです。つまり、欧州 (フランクフルト) のエンドポイントを介して作成されたチャネルは、欧州 (フランクフルト) 経由でのみ変更できます。また、米国東部 (バージニア北部) の Chime 名前空間を使用して ChimeSDKMessaging 名前空間を介して作成されたチャネルに対応できないことも意味します。現在のエンドポイントの詳細については、このガイドの「API マッピング」を参照してください。
サービスプリンシパル
Amazon Chime SDK Messaging 名前空間は、新しいサービスプリンシパル messaging.chime.amazonaws.com を使用します。サービスへのアクセスを許可する SQS、SNS またはその他の IAM アクセスポリシーがある場合は、それらのポリシーを更新して新しいサービスプリンシパルへのアクセスを許可する必要があります。
API
Amazon Chime SDK Messaging 名前空間には、メッセージングリソースの作成と管理、およびメッセージの送受信のための API のみが含まれています。Amazon Chime 名前空間には、メッセージング用および Amazon Chime サービスのその他の部分用の API が含まれています。
チャネルフロー
チャネルフローを使用すると、送信中のメッセージがメッセージングチャネルのメンバーに配信される前に、そのメッセージに対してビジネスロジックを実行できます。例えば、行政 ID 番号、電話番号、または冒涜的な表現などの機密データをメッセージが配信される前に削除するフローを作成できます。これは、企業のコミュニケーションポリシーやその他のコミュニケーションガイドラインを実施するのに役立ちます。
投票アンケートへの回答を集約した後で結果を参加者に返送する、メッセージを SMS で送信するなどの機能を実行するためにチャネルフローを使用することもできます。
チャネルフローは ChimeSDKMessaging 名前空間でのみ使用できます。詳細については、このガイドの「チャネルフローを使用したメッセージの処理」を参照してください。
Elastic チャネル
Elastic チャネルは、所定の数のサブチャネル間で最大 100 万人のチャットユーザーを自動的にバランスよく分散する、大規模なチャット体験をサポートします。Elastic チャネルは ChimeSDKMessaging エンドポイントでのみ使用できます。Elastic チャネルの詳細については、このガイドの「Elastic チャネルを使用してライブイベントをホストする」を参照してください。
その他の API
Messaging 名前空間には、Chime 名前空間にはない API が増え続けています。Amazon Chime SDK の使用を開始する場合は、メッセージング名前空間を使用してすべての最新機能にアクセスできるようにしてください。現在の API の詳細については、「Amazon Chime SDK API Reference」の「Amazon Chime SDK Messaging」を参照してください。
