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

# 迁移到 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 身份资源（包括和）的 API 的专用位置。 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)。

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

## 迁移之前
<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 | 
| API | 仅用于身份的 API | 用于身份和 Amazon Chime 其他部分的 API | 
| 用户过期 | 可用 | 不可用 | 
| 自动程序 | 可用 | 不可用 | 

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

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

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

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

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

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

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

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

**端点**  
[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 命名空间 AppInstance 创建的 Chime 命名空间`us-east-1`，也无法在创建和成员的区域以外的区域中创建频道。 AppInstance AppInstanceUser 有关当前终端节点的更多信息，请参阅本指南中的 [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 访问策略，则需要更新这些策略以授予新服务主体访问权限。

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

**用户过期**  
创建时的过期设置 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) API 将由 Amazon Lex V2 提供支持的聊天机器人添加到您的应用程序中。您只能在身份命名空间 AppInstanceBots 中使用。有关自动程序的更多信息，请参阅本指南中的 [用 AppInstanceBots 作 Amazon Chime SDK 消息传递的智能渠道代理](appinstance-bots.md)。

**其它 API**  
身份命名空间的其他 API 列表越来越多，而 Chime 命名空间没有这些 API。如果您刚开始使用 Amazon Chime SDK，请使用身份命名空间来访问所有最新功能。有关当前 API 的更多信息，请参阅《Amazon Chime SDK API 参考》**中的 [Amazon Chime SDK 身份](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html)。