翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Chime SDK Messaging 名前空間への移行
[Amazon Chime SDK Messaging](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) 名前空間は、Amazon Chime SDK メッセージングリソースを作成および管理する API のための専用の場所です。この名前空間を使用すると、任意の AWS リージョンの Amazon Chime SDK メッセージング API エンドポイントをアドレス指定できます (そのリージョンでそれらのエンドポイントを利用できる場合)。Amazon Chime SDK を使い始めたばかりの場合は、この名前空間を使用してください。リージョンの詳細については、このガイドの「[Amazon Chime SDK で利用可能な AWS リージョン](sdk-available-regions.md)」を参照してください。
[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 名前空間を使用する既存のアプリケーションでは、専用の名前空間への移行を計画する必要があります。
**Topics**
+ [移行すべき理由](#migration-reasons)
+ [移行する前に](#before-migrating)
+ [名前空間の相違点](#namespace-differences)
## 移行すべき理由
以下の理由から、[Amazon Chime SDK Messaging](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) 名前空間に移行することをお勧めします。
**API エンドポイントの選択**
Amazon Chime SDK Messaging 名前空間は、[API エンドポイントを利用できる任意のリージョン](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html)の API エンドポイントを使用できる唯一の API 名前空間です。米国東部 (バージニア北部) 以外の API エンドポイントを使用する場合は、Amazon Chime SDK Messaging 名前空間を使用する必要があります。
Amazon Chime SDK メッセージングが AWS リージョンを使用する方法の詳細については、このガイドの[「利用可能なリージョン](https://docs.aws.amazon.com/chime-sdk/latest/dg/available-regions.html)」を参照してください。
**メッセージング 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](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 名前空間は、`US East (N. Virginia)` リージョンの API エンドポイントのみをアドレス指定します。[Amazon Chime SDK Messaging](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) 名前空間は、利用可能な任意のリージョンで Amazon Chime SDK メッセージング API エンドポイントをアドレス指定できます。メッセージングリージョンの最新リストについては、本ガイドの「[Amazon Chime SDK で利用可能な AWS リージョン](sdk-available-regions.md)」を参照してください。
**エンドポイント**
[Amazon Chime SDK Messaging](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) 名前空間は、[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 名前空間とは異なる API エンドポイントを使用します。
メッセージングリソースを変更するために使用できるのは、メッセージングリソースの作成に使用したエンドポイントだけです。つまり、`Europe (Frankfurt)` のエンドポイントを介して作成されたメッセージングリソースは、`Europe (Frankfurt)` 経由でしか変更できないということです。これは、欧州 (フランクフルト) のエンドポイントを介して作成されたチャネルは、欧州 (フランクフルト) を介してのみ変更できるということです。また、`Chime` 名前空間を介して作成されたチャネルを、米国東部 (バージニア北部) の `ChimeSDKMessaging` 名前空間でアドレス指定することもできません。現在のエンドポイントの詳細については、このガイドの「[API マッピング](migrate-from-chm-namespace.md#name-end-map)」を参照してください。
**サービスプリンシパル**
[Amazon Chime SDK Messaging](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) 名前空間は、新しいサービスプリンシパル `messaging.chime.amazonaws.com` を使用します。サービスへのアクセスを許可する SQS、SNS またはその他の IAM アクセスポリシーがある場合は、それらのポリシーを更新して新しいサービスプリンシパルへのアクセスを許可する必要があります。
**API**
[Amazon Chime SDK Messaging](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) 名前空間には、メッセージングリソースの作成と管理、およびメッセージの送受信のための API のみが含まれています。[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 名前空間には、メッセージング用および Amazon Chime サービスのその他の部分用の API が含まれています。
**チャネルフロー**
チャネルフローを使用すると、送信中のメッセージがメッセージングチャネルのメンバーに配信される前に、そのメッセージに対してビジネスロジックを実行できます。例えば、行政 ID 番号、電話番号、または冒涜的な表現などの機密データをメッセージが配信される前に削除するフローを作成できます。これは、企業のコミュニケーションポリシーやその他のコミュニケーションガイドラインを実施するのに役立ちます。
投票アンケートへの回答を集約した後で結果を参加者に返送する、メッセージを SMS で送信するなどの機能を実行するためにチャネルフローを使用することもできます。
チャネルフローは `ChimeSDKMessaging` 名前空間でのみ使用できます。詳細については、このガイドの「[チャネルフローを使用した Amazon Chime SDK メッセージングのメッセージの処理](using-channel-flows.md)」を参照してください。
**Elastic チャネル**
Elastic チャネルは、所定の数のサブチャネル間で最大 100 万人のチャットユーザーを自動的にバランスよく分散する、大規模なチャット体験をサポートします。Elastic チャネルは `ChimeSDKMessaging` エンドポイントでのみ使用できます。Elastic チャネルの詳細については、このガイドの「[Elastic チャネルを使用して Amazon Chime SDK ミーティングでライブイベントをホストする](elastic-channels.md)」を参照してください。
**その他の API**
Messaging 名前空間には、`Chime` 名前空間にはない API が増え続けています。Amazon Chime SDK の使用を開始する場合は、メッセージング名前空間を使用してすべての最新機能にアクセスできるようにしてください。現在の API の詳細については、「*Amazon Chime SDK API Reference*」の「[Amazon Chime SDK Messaging](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html)」を参照してください。