Amazon Chime SDK Voice 名前空間への移行 - Amazon Chime SDK

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

Amazon Chime SDK Voice 名前空間への移行

Amazon Chime SDK Voice 名前空間は、Amazon Chime SDK音声リソースAPIsを作成および管理する 専用の場所です。名前空間を使用して、任意の で Amazon Chime SDK音声APIエンドポイントをアドレス指定します。 AWS それらを利用可能にするリージョン。Amazon Chime の使用を開始したばかりの場合はSDK、この名前空間を使用します。リージョンの詳細については、このガイドの「利用できるリージョン」を参照してください。

Amazon Chime 名前空間を使用する既存のアプリケーションでは、更新された機能APIsや新機能を使用するには、専用の名前空間への移行を計画する必要があります。

移行すべき理由

次の理由から、Amazon Chime SDK Voice 名前空間に移行することをお勧めします。

API エンドポイントの選択

Amazon Chime SDK Voice 名前空間を使用すると、 を利用できる任意のリージョンでAPIエンドポイントを使用できます。以外のAPIエンドポイントを使用する場合はus-east-1、Amazon Chime SDK Voice 名前空間を使用する必要があります。現在のエンドポイントの詳細については、このガイドの「API マッピング」を参照してください。

音声の更新と新規作成 APIs

Amazon Chime SDK Voice 名前空間APIsでのみ音声を追加または更新します。

移行する前に

移行する前に、名前空間の相違点に注意してください。 以下の表では、名前空間の一覧と説明を示しています。

Amazon Chime SDK Voice 名前空間

Amazon Chime 名前空間

AWS 名前空間

ChimeSDKVoice

Chime

リージョン

複数

us-east-1 のみ

エンドポイント

https://voice-chime.region.amazonaws.com

service.chime.aws.amazon.com

サービスプリンシパル

chime.amazonaws.com

chime.amazonaws.com

APIs

PSTN Audio サービスAPIsのみ

APIs for PSTN Audio と Amazon Chime のその他の部分

音声コネクタ管理 複数のリージョン 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形式名を使用します。名前の正確な形式はプラットフォームによって異なります。

例えば、 AWS SDK Node.js で会議を作成するには、次のコード行を使用して名前空間に対処します。

const chimeVoice = AWS.Chime();

Amazon Chime SDK Voice 名前空間に移行するには、このコード行を新しい名前空間とエンドポイントリージョンで更新します。

const chimeVoice = AWS.ChimeSDKVoice({ region: "eu-central-1" });
リージョン

Amazon Chime 名前空間は、 us-east-1リージョン内のAPIエンドポイントにのみ対応できます。Amazon Chime SDK Voice 名前空間は、利用可能な任意のリージョンの Amazon Chime SDK音声APIエンドポイントに対応できます。現在の音声リージョンのリストについては、本ガイドの「利用できるリージョン」を参照してください。

エンドポイント

Amazon Chime SDK Voice 名前空間は、Amazon Chime 名前空間とは異なるAPIエンドポイントを使用します。

音声アクションを変更するのに使用できるのは、その作成に使用したエンドポイントだけです。つまり、eu-central-1 のエンドポイントを介して作成された音声アクションは、eu-central-1 経由でしか変更できないということです。また、Chime 名前空間を介して作成された音声アクションは、us-east-1ChimeSDKVoice 名前空間ではアドレス指定できません。現在のエンドポイントの詳細については、このガイドの「API マッピング」を参照してください。

サービスプリンシパル

どちらの名前空間も chime.amazonaws.com サービスプリンシパルを使用します。サービスへのアクセスを許可するアクセスポリシーがある場合、それらのポリシーを更新する必要はありません。

APIs

Amazon Chime SDK Voice 名前空間には、音声アクションを作成および管理APIsするための のみが含まれます。Amazon Chime 名前空間には、音声および会議などの Amazon Chime サービスの他の部分APIs用の が含まれます。

タグ付け

Amazon Chime SDK Voice 名前空間のみがタグをサポートします。タグの詳細については、「」を参照してください。 TagResource および UntagResource.

メディアリージョン

Chime 名前空間を使用して Voice Connector やSIPメディアアプリケーションなどのリソースを作成する場合は、 us-east-1と でのみ作成できus-west-2us-east-1エンドポイントを使用する必要があります。

これに対して、ChimeSDKVoice 名前空間では、us-east-1us-west-2 だけでなく、サポートされているすべてのリージョンでリソースを作成できます。リージョンカバレッジの詳細については、「利用できるリージョン」を参照してください。