迁移到 Amazon Chime SDK 身份命名空间

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

使用 Amazon Chime 命名空间的现有应用程序应计划迁移到专用命名空间。

迁移原因

出于以下原因，我们鼓励您迁移到 Amazon Chime SDK 身份命名空间：

选择 API 终端节点

Amazon Chime SDK 身份命名空间是唯一可以在任何提供 API 终端节点的区域中使用 API 终端节点的 API 命名空间。如果您想使用 us-east-1 以外的 API 终端节点，则必须使用 Amazon Chime SDK 身份命名空间。有关当前终端节点的更多信息，请参阅本指南中的 API 映射。

更新和新的消息传递 API

我们仅在 Amazon Chime SDK 身份命名空间中添加或更新身份 API。

迁移之前

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

	Amazon Chime SDK 身份命名空间	Amazon Chime 命名空间
AWS SDK 命名空间	ChimeSDKIdentity	Chime
区域	多个	仅限 us-east-1
服务主体	https://identity.chime.amazonaws.com	https://chime.amazonaws.com
API	仅用于身份的 API	用于身份和 Amazon Chime 其他部分的 API
用户过期	可用	不可用
自动程序	可用	不可用

命名空间之间的差异

以下各节解释了 Chime 和 ChimeSDKIdentity 命名空间之间的差异。

AWS SDK 命名空间

Amazon Chime SDK 命名空间使用 Chime 正式名称。Amazon Chime SDK 身份命名空间使用 ChimeSDKIdentity 正式名称。名称的确切格式因平台而异。

例如，如果您在 Node.js 中使用 AWS SDK 来创建身份，则使用一行代码来寻址命名空间。

const chimeIdentity = AWS.Chime();

若要迁移到 ChimeSDKIdentity 命名空间，请使用新的命名空间和终端节点区域更新这行代码。

const chimeIdentity = AWS.ChimeSDKIdentity({ region: "eu-central-1" });

区域

Amazon Chime 命名空间只能寻址该 us-east-1 地区的 API 终端节点。Amazon Chime SDK 身份命名空间可以在任何可用区域中寻址 Amazon Chime SDK 身份 API 终端节点。有关终端节点区域的最新列表，请参阅本指南中的 Amazon Chime SDK 可用的 AWS 区域。

端点

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

只有用于创建身份资源的终端节点才能用于更新这些资源。这意味着通过 eu-central-1 中的终端节点创建的 AppInstance 只能通过 eu-central-1 进行修改。这也意味着您无法使用 us-east-1 中的 ChimeSDKIdentity 命名空间寻址通过 Chime 命名空间创建的 AppInstance，或在创建 AppInstance 和 AppInstanceUser 成员的区域以外的区域中创建频道。有关当前终端节点的更多信息，请参阅本指南中的 API 映射。

服务主体

Amazon Chime SDK 身份命名空间使用了新的服务主体：Identity.chime.amazonaws.com。如果您有授予服务访问权限的 SQS、SNS 或其他 IAM 访问策略，则需要更新这些策略以授予新服务主体访问权限。

API

Amazon Chime SDK 身份命名空间仅包含用于创建和管理消息资源以及发送和接收消息的 API。Amazon Chime 命名空间包括用于 Amazon Chime 服务其他部分的 API 以及消息传递。

用户过期

创建 AppInstanceUser 时的过期设置允许您创建临时用户。例如，您可以创建仅在大型广播期间存在的聊天用户。只有身份命名空间支持 AppInstanceUser 的过期设置。

自动程序

您可以使用 AppInstanceBot API 将由 Amazon Lex V2 提供支持的聊天机器人添加到您的应用程序中。您只能在身份命名空间中使用 AppInstanceBot。有关自动程序的更多信息，请参阅本指南中的 在 Amazon Chime SDK 消息传递中使用 AppInstanceBot 作为智能频道座席。。

其它 API

身份命名空间的其他 API 列表越来越多，而 Chime 命名空间没有这些 API。如果您刚开始使用 Amazon Chime SDK，请使用身份命名空间来访问所有最新功能。有关当前 API 的更多信息，请参阅《Amazon Chime SDK API 参考》中的 Amazon Chime SDK 身份。