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

迁移到 Amazon Chime SDK 语音命名空间

Amazon Chime SDK 语音命名空间是 API 的专用位置，用于创建和管理 Amazon Chime SDK 语音资源。您可以使用命名空间来寻址 Amazon Chime SDK 语音 API 终端节点在任何提供语音 API 终端节点的 AWS 区域。如果您刚开始使用 Amazon Chime SDK，则使用此命名空间。有关“区域”的更多信息，请参阅本指南中的 可用区。

使用 Amazon Chime 命名空间的现有应用程序应计划迁移到专用命名空间，以使用更新后的 API 和新功能。

迁移原因

我们建议迁移到 Amazon Chime SDK 语音命名空间，原因如下：

迁移之前

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

有关可用“区域”的更多信息，请参阅本指南中前面的 PSTN 区域。

命名空间之间的差异

以下各节解释了 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 命名空间只能寻址该 us-east-1 地区的 API 终端节点。Amazon Chime SDK 语音命名空间可以在任何可用区域寻址 Amazon Chime SDK 语音 API 终端节点。有关语音区域的最新列表，请参阅本指南中的 可用区。

端点

Amazon Chime SDK 语音命名空间使用不同于 Amazon Chime 命名空间的 API 终端节点。

只能使用用于创建语音操作的终端节点对其进行修改。这意味着通过 eu-central-1 中的终端节点创建的语音操作只能通过 eu-central-1 进行修改。这也意味着您无法使用 us-east-1 中的 ChimeSDKVoice 命名空间寻址通过 Chime 命名空间创建的语音操作。有关当前终端节点的更多信息，请参阅本指南中的 API 映射。

服务主体

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

API

Amazon Chime SDK 语音命名空间仅包含用于创建和管理语音操作的 API。Amazon Chime 命名空间包括用于语音和 Amazon Chime 服务其他部分（例如会议）的 API。

标记

只有 Amazon Chime SDK 语音命名空间支持标签。有关标签的更多信息，请参阅TagResource和UntagResource。

媒体区域

如果您使用 Chime 命名空间创建诸如语音连接器和 SIP 媒体应用程序等资源，则只能在 us-east-1 和 us-west-2 中执行此操作，并且必须使用 us-east-1 终端节点。

相反，ChimeSDKVoice 命名空间允许在所有支持的区域中创建资源，不仅仅是 us-east-1 和 us-west-2。有关区域覆盖的更多信息，请参阅 可用区。