本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
迁移到 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 语音命名空间,原因如下:
- 选择 API 终端节点
Amazon Chime SDK 语音命名空间允许您在任何提供 API 终端节点的区域使用该终端节点。如果您想使用
us-east-1
以外的 API 终端节点,则必须使用 Amazon Chime SDK 语音命名空间。有关当前终端节点的更多信息,请参阅本指南中的 API 映射。- 更新和新的语音 API
我们仅在 Amazon Chime SDK 语音命名空间中添加或更新语音 API。
迁移之前
在迁移之前,记下命名空间之间的差异。下表列出并描述了以上差异。
Amazon Chime SDK 语音命名空间 |
Amazon Chime 命名空间 |
|
---|---|---|
AWS 命名空间 |
|
|
区域 |
多个 |
仅限 |
端点 |
|
|
服务主体 |
|
|
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 |
有关可用“区域”的更多信息,请参阅本指南中前面的 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
。有关区域覆盖的更多信息,请参阅 可用区。