本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 迁移到 Amazon Chime SDK 语音命名空间
<a name="voice-namespace-migration"></a>

[Amazon Chime SDK 语音](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html)命名空间是 API 的专用位置，用于创建和管理 Amazon Chime SDK 语音资源。您可以使用命名空间来寻址 Amazon Chime SDK 语音 API 终端节点在任何提供语音 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 语音](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html)命名空间，原因如下：

**选择 API 终端节点**  
Amazon Chime SDK 语音命名空间允许您在任何提供 [API 终端节点的区域](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html)使用该终端节点。如果您想使用 `us-east-1` 以外的 API 终端节点，则必须使用 Amazon Chime SDK 语音命名空间。有关当前终端节点的更多信息，请参阅本指南中的 [API 映射](migrate-from-chm-namespace.md#name-end-map)。

**更新和新的语音 API**  
我们仅在 Amazon Chime SDK 语音命名空间中添加或更新语音 API。

## 迁移之前
<a name="voice-before-migrate"></a>

在迁移之前，记下命名空间之间的差异。下表列出并描述了以上差异。


|  | Amazon Chime SDK 语音命名空间 | 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 语音命名空间使用 `ChimeSDKVoice` 正式名称。名称的确切格式因平台而异。

例如，如果您在中 Node.js 使用 AWS 软件开发工具包创建会议，则使用以下代码行来处理命名空间。

```
const chimeVoice = AWS.Chime();
```

要迁移到 Amazon Chime SDK 语音命名空间，使用新的命名空间和终端节点区域更新该代码行。

```
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 语音](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 语音](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` 进行修改。这也意味着您无法使用 `us-east-1` 中的 `ChimeSDKVoice` 命名空间寻址通过 `Chime` 命名空间创建的语音操作。有关当前终端节点的更多信息，请参阅本指南中的 [API 映射](migrate-from-chm-namespace.md#name-end-map)。

**服务主体**  
两个命名空间都使用 `chime.amazonaws.com` 服务主体。如果您有授予服务访问权限的访问策略，则无需更新这些策略。

**API**  
[Amazon Chime SDK 语音](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。

**标签**  
只有 [Amazon Chime SDK 语音](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)。