翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Chime SDK 音声名前空間への移行
Amazon Chime SDK Voice 名前空間は、Amazon Chime SDK 音声リソースを作成および管理する API のための専用の場所です。名前空間を使用して、Amazon Chime SDK 音声 API エンドポイントを使用可能にする任意の AWS リージョンのエンドポイントに対処します。Amazon Chime SDK を使い始めたばかりの場合は、この名前空間を使用してください。リージョンの詳細については、このガイドの「Amazon Chime SDK で利用可能な AWS リージョン」を参照してください。
Amazon Chime 名前空間を使用する既存のアプリケーションでは、更新された API と新機能を使用するために、専用の名前空間への移行を計画する必要があります。
移行すべき理由
Amazon Chime SDK Voice 名前空間への移行をお勧めするのは、以下の理由からです。
- API エンドポイントの選択
-
Amazon Chime SDK Voice 名前空間により、API エンドポイントを利用可能にする任意のリージョンで API エンドポイントを使用できるようになります。
us-east-1以外の API エンドポイントを使用する場合は、Amazon Chime SDK Voice 名前空間を使用する必要があります。現在のエンドポイントの詳細については、このガイドの「API マッピング」を参照してください。 - 音声 API の更新および新規追加
-
Amazon Chime SDK Voice 名前空間の音声 API のみ追加または更新されます。
移行する前に
移行する前に、名前空間の相違点に注意してください｡ 以下の表では、名前空間の一覧と説明を示しています。
Amazon Chime SDK Voice 名前空間 |
Amazon Chime 名前空間 |
|
|---|---|---|
AWS 名前空間 |
|
|
リージョン |
複数 |
|
エンドポイント |
|
|
サービスプリンシパル |
|
|
API |
PSTN オーディオサービス用の API のみ | PSTN オーディオおよび Amazon Chime のその他の部分用の API |
| 音声コネクタ管理 | 複数のリージョン | us-east-1 |
| 音声コネクタグループ管理 | 複数のリージョン | us-east-1 |
| SIP メディアアプリケーションおよび SIP ルール管理 | 複数のリージョン | us-east-1 |
| 電話番号管理 | 複数のリージョン | us-east-1 |
| 通話分析 | 利用可能 | 利用不可 |
| 音声プロファイルドメイン | 利用可能 | 利用不可 |
| 緊急通報管理 | 複数のリージョン | us-east-1 |
| プロキシ電話セッション管理 | 複数のリージョン | us-east-1 |
| ストリーミング管理 | 複数のリージョン | us-east-1 |
| ログ記録およびメトリクス管理 | 複数のリージョン | us-east-1 |
使用可能なリージョンの詳細については、「音声リージョン」を参照してください。
名前空間の相違点
以下のセクションでは、Amazon Chime SDK Voice 名前空間と Amazon Chime 名前空間の相違点について説明します。
AWS 名前空間
Amazon Chime SDK 名前空間では Chime という正式名を使用します。Amazon Chime SDK Voice 名前空間では ChimeSDKVoice という正式名を使用します。名前の正確な形式はプラットフォームによって異なります。
例えば、Node.js で AWS SDK を使用して会議を作成する場合、次のコード行を使用して名前空間に対処します。
const chimeVoice = AWS.Chime();
Amazon Chime SDK Voice 名前空間に移行するには、このコード行を新しい名前空間とエンドポイントリージョンで更新します。
const chimeVoice = AWS.ChimeSDKVoice({ region: "eu-central-1" });
Regions
Amazon Chime 名前空間は、us-east-1 リージョンの API エンドポイントのみをアドレス指定します。Amazon Chime SDK Voice 名前空間は、利用可能な任意のリージョンで Amazon Chime SDK 音声 API エンドポイントをアドレス指定できます。現在の音声リージョンのリストについては、本ガイドの「Amazon Chime SDK で利用可能な AWS リージョン」を参照してください。
エンドポイント
Amazon Chime SDK Voice 名前空間は、Amazon Chime 名前空間とは異なる API エンドポイントを使用します。
音声アクションを変更するのに使用できるのは、その作成に使用したエンドポイントだけです。つまり、eu-central-1 のエンドポイントを介して作成された音声アクションは、eu-central-1 経由でしか変更できないということです。また、Chime 名前空間を介して作成された音声アクションは、us-east-1 の ChimeSDKVoice 名前空間ではアドレス指定できません。現在のエンドポイントの詳細については、このガイドの「API マッピング」を参照してください。
サービスプリンシパル
どちらの名前空間も chime.amazonaws.com サービスプリンシパルを使用します。サービスへのアクセスを許可するアクセスポリシーがある場合、それらのポリシーを更新する必要はありません。
API
Amazon Chime SDK Voice 名前空間には、音声アクションを作成および管理するための API のみが含まれています。Amazon Chime 名前空間には、音声や Amazon Chime サービスのその他の部分 (会議など) のための API が含まれています。
Tagging
Amazon Chime SDK Voice 名前空間のみがタグをサポートしています。タグの詳細については、「TagResource」と「UntagResource」を参照してください。
メディアリージョン
Chime 名前空間を使用して、音声コネクタや SIP メディアアプリケーションなどのリソースを作成する場合、これを実行できるのは us-east-1 と us-west-2 だけであり、us-east-1 エンドポイントを使用する必要があります。
これに対して、ChimeSDKVoice 名前空間では、us-east-1 と us-west-2 だけでなく、サポートされているすべてのリージョンでリソースを作成できます。リージョンカバレッジの詳細については、「Amazon Chime SDK で利用可能な AWS リージョン」を参照してください。
