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

# 迁移到 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)命名空间是创建和管理 Amazon Chime SDK 语音资源的专用场所。 APIs 您可以使用命名空间来寻址 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) 命名空间的现有应用程序应计划迁移到专用命名空间，以便使用更新的 APIs 和新的功能。

**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)。

**更新和新声音 APIs**  
我们只在 Amazon Chime SDK 语音命名空间 APIs 中添加或更新语音。

## 迁移之前
<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` | 
| **APIs** | 仅 APIs 适用于 PSTN 音频服务 | APIs 适用于 PSTN 音频和 Amazon Chime 的其他部分 | 
| 语音连接器管理 | 多个区域 | us-east-1 | 
| 语音连接器组管理 | 多个区域 | us-east-1 | 
| SIP 媒体应用程序和 SIP 规则管理 | 多个区域 | us-east-1 | 
| 电话号码管理 | 多个区域 | us-east-1 | 
| 呼叫分析 | Available | 不可用 | 
| 语音配置文件域 | Available | 不可用 | 
| 紧急调用管理 | 多个区域 | 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 SDK 创建会议，则使用以下代码行来处理命名空间。

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

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

```
const chimeVoice = AWS.ChimeSDKVoice({ region: "eu-central-1" });
```

**区域**  
[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)。

**了解如何查看、监控和管理 SageMaker 端点。**  
[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` 服务主体。如果您有授予服务访问权限的访问策略，则无需更新这些策略。

**APIs**  
[Amazon Chime SDK 语音](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html)命名空间仅包含 APIs 用于创建和管理语音操作的内容。[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 命名空间包括 APIs 语音和 Amazon Chime 服务的其他部分，例如会议。

**标记**  
只有 [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)。