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

# Amazon Chime SDK 音声名前空間への移行
<a name="voice-namespace-migration"></a>

[Amazon Chime SDK Voice](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 名前空間は、Amazon Chime SDK 音声リソースを作成および管理する API のための専用の場所です。名前空間を使用して、Amazon Chime SDK 音声 API エンドポイントを使用可能にする任意の AWS リージョンのエンドポイントに対処します。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) 名前空間を使用する既存のアプリケーションでは、更新された API と新機能を使用するために、専用の名前空間への移行を計画する必要があります。

**Topics**
+ [移行すべき理由](#first-concept-chapter)
+ [移行する前に](#voice-before-migrate)
+ [名前空間の相違点](#voice-namespace-diffs)

## 移行すべき理由
<a name="first-concept-chapter"></a>

[Amazon Chime SDK Voice](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 名前空間への移行をお勧めするのは、以下の理由からです。

**API エンドポイントの選択**  
Amazon Chime SDK Voice 名前空間により、[API エンドポイントを利用可能にする任意のリージョン](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html)で API エンドポイントを使用できるようになります。`us-east-1` 以外の API エンドポイントを使用する場合は、Amazon Chime SDK Voice 名前空間を使用する必要があります。現在のエンドポイントの詳細については、このガイドの「[API マッピング](migrate-from-chm-namespace.md#name-end-map)」を参照してください。

**音声 API の更新および新規追加**  
Amazon Chime SDK Voice 名前空間の音声 API のみ追加または更新されます。

## 移行する前に
<a name="voice-before-migrate"></a>

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


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

使用可能なリージョンの詳細については、「[音声リージョン](sdk-available-regions.md#voice-regions)」を参照してください。

## 名前空間の相違点
<a name="voice-namespace-diffs"></a>

以下のセクションでは、`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](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 名前空間は、`us-east-1` リージョンの API エンドポイントのみをアドレス指定します。[Amazon Chime SDK Voice](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 名前空間は、利用可能な任意のリージョンで Amazon Chime SDK 音声 API エンドポイントをアドレス指定できます。現在の音声リージョンのリストについては、本ガイドの「[Amazon Chime SDK で利用可能な AWS リージョン](sdk-available-regions.md)」を参照してください。

**エンドポイント**  
[Amazon Chime SDK Voice](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 名前空間は、[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 名前空間とは異なる API エンドポイントを使用します。

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

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

**API**  
[Amazon Chime SDK Voice](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 名前空間には、音声アクションを作成および管理するための API のみが含まれています。[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 名前空間には、音声や Amazon Chime サービスのその他の部分 (会議など) のための API が含まれています。

**Tagging**  
[Amazon Chime SDK Voice](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 名前空間のみがタグをサポートしています。タグの詳細については、「[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_TagResource.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_TagResource.html)」と「[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UntagResource.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UntagResource.html)」を参照してください。

**メディアリージョン**  
`Chime` 名前空間を使用して、音声コネクタや SIP メディアアプリケーションなどのリソースを作成する場合、これを実行できるのは `us-east-1` と `us-west-2` だけであり、`us-east-1` エンドポイントを使用する必要があります。

これに対して、`ChimeSDKVoice` 名前空間では、`us-east-1` と `us-west-2` だけでなく、サポートされているすべてのリージョンでリソースを作成できます。リージョンカバレッジの詳細については、「[Amazon Chime SDK で利用可能な AWS リージョン](sdk-available-regions.md)」を参照してください。