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

# 迁移到 Amazon Chime SDK 身份命名空间
<a name="identity-namespace-migration"></a>

[Amazon Chime SDK 身份](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html)命名空间是用户创建和管理 Amazon Chime SDK 身份资源（包括和）的专用场所。 APIs AppInstances AppInstanceUsers您可以使用命名空间来寻址 Amazon Chime SDK 身份 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) 命名空间的现有应用程序应计划迁移到专用命名空间。

**Topics**
+ [迁移原因](#identity-migration-reasons)
+ [迁移之前](#id-before-migrating)
+ [命名空间之间的差异](#id-namespace-differences)

## 迁移原因
<a name="identity-migration-reasons"></a>

出于以下原因，我们鼓励您迁移到 [Amazon Chime SDK 身份](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html)命名空间：

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

**更新和新的消息 APIs**  
我们只在 Amazon Chime SDK 身份命名空间 APIs 中添加或更新身份。

## 迁移之前
<a name="id-before-migrating"></a>

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


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

## 命名空间之间的差异
<a name="id-namespace-differences"></a>

以下各节解释了 `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](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_Identity.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_Identity.html)命名空间使用不同于 [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 命名空间的 API 终端节点。

只有用于创建身份资源的终端节点才能用于更新这些资源。这意味着通过中的端点 AppInstance 创建的`eu-central-1`只能通过进行修改`eu-central-1`。这也意味着你不能在使用 Chime 命名空间的情况下寻址通过 Chime SDKIdentity 命名空间创建的频道`us-east-1`，也不能在创建 AppInstance 和 AppInstanceUser 成员的区域之外的区域中创建频道。 AppInstance 有关当前终端节点的更多信息，请参阅本指南中的 [API 映射](migrate-from-chm-namespace.md#name-end-map)。

**服务主体**  
[Amazon Chime SDK 身份](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html)命名空间使用了新的服务主体：`Identity.chime.amazonaws.com`。如果您有授予服务访问权限的 SQS、SNS 或其他 IAM 访问策略，则需要更新这些策略以授予新服务主体访问权限。

**APIs**  
[Amazon Chime SDK 身份](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html)命名空间仅包含 APIs 用于创建和管理消息资源以及用于发送和接收消息的内容。A [mazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 命名空间包括 APIs 亚马逊 Chime 服务的其他部分以及消息。

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

**自动程序**  
你用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_identity-chime_AppInstanceBot.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_identity-chime_AppInstanceBot.html)用于将由 Amazon Lex V2 提供支持的聊天机器人添加到您的应用程序中的 API。您只能在身份命名空间 AppInstanceBots 中使用。有关自动程序的更多信息，请参阅本指南中的 [用 AppInstanceBots 作 Amazon Chime SDK 消息传递的智能渠道代理](appinstance-bots.md)。

**额外 APIs**  
Identity 命名空间越来越多了 Chime 命名空间所没有的额外 APIs 内容。如果您刚开始使用 Amazon Chime SDK，请使用身份命名空间来访问所有最新功能。有关当前版本的更多信息 APIs，请参阅《[亚马逊 Chime SDK API 参考》中的 A *mazon Chime* SDK 身份](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html)。