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

# 迁移到 Amazon Chime SDK 消息传递命名空间
<a name="messaging-namespace-migration"></a>

[Amazon Chime SDK 消息传递](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html)命名空间是创建和管理 Amazon Chime SDK 消息资源的专用场所。 APIs 您可以使用命名空间在 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**
+ [迁移原因](#migration-reasons)
+ [迁移之前](#before-migrating)
+ [命名空间之间的差异](#namespace-differences)

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

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

**选择 API 终端节点**  
Amazon Chime SDK 消息传递命名空间是唯一可以在任何[提供 API 端点的区域](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html)中使用 API 端点的 API 命名空间。如果您想使用美国东部（弗吉尼亚州北部）以外的 API 端点，则必须使用 Amazon Chime SDK 消息传递命名空间。  
有关 Amazon Chime SDK 消息传递如何使用 AWS 区域的更多信息，请参阅本指南中的[可用区域](https://docs.aws.amazon.com/chime-sdk/latest/dg/available-regions.html)。

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

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

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


|  | Amazon Chime SDK 消息传递命名空间 | Amazon Chime 命名空间 | 
| --- | --- | --- | 
| AWS SDK 名称空间 | ChimeSDKMessaging | Chime | 
| 区域 | 多个 | 仅限美国东部（弗吉尼亚州北部） | 
| APIs | 仅 APIs 用于发送消息 | APIs 用于消息和 Amazon Chime 的其他部分 | 
| 流 | 可用 | 不可用 | 
| 弹性频道 | 可用 | 不可用 | 

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

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

**AWS SDK 名称空间**  
Amazon Chime SDK 命名空间使用 `Chime` 正式名称。Amazon Chime SDK 消息传递命名空间使用 `ChimeSDKMessaging` 正式名称。名称的确切格式因平台而异。

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

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

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

```
const chimeMessaging = AWS.ChimeSDKMessaging({ region: "Europe (Frankfurt)" });
```

**Regions**  
[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 命名空间只能寻址该 `US East (N. Virginia)` 地区的 API 终端节点。[Amazon Chime SDK 消息传递](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.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_Messaging.html)命名空间使用与 [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 命名空间不同的 API 终端节点。

只能使用用于创建消息传递资源的终端节点对其进行修改。这意味着通过 `Europe (Frankfurt)` 中的终端节点创建的消息传递资源只能通过 `Europe (Frankfurt)` 进行修改。这意味着通过欧洲地区（法兰克福）中的端点创建的频道只能通过欧洲地区（法兰克福）进行修改。这也意味着您无法寻址通过 `Chime` 命名空间创建且 `ChimeSDKMessaging` 命名空间位于美国东部（弗吉尼亚州北部）的频道。有关当前终端节点的更多信息，请参阅本指南中的 [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)命名空间使用了新的服务主体：`messaging.chime.amazonaws.com`。如果您有授予服务访问权限的 SQS、SNS 或其他 IAM 访问策略，则需要更新这些策略以授予新服务主体访问权限。

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

**频道流**  
频道流允许开发人员在将动态消息传递给消息传递频道成员之前，对这些消息运行业务逻辑。例如，您可以创建流程，在发送消息之前从消息中删除敏感数据，例如身份证号、电话号码或污言秽语。这可以帮助实施企业传播策略或其他沟通准则。

您还可以使用频道流来执行一些功能，例如在将结果发送回给参与者之前汇总对民意调查的回复，或者通过短信发送消息。

频道流仅在 `ChimeSDKMessaging` 命名空间中可用。有关更多信息，请参阅本指南中的 [在 Amazon Chime SDK 消息传递中使用频道流来处理消息](using-channel-flows.md)。

**弹性频道**  
弹性频道支持大规模的聊天体验，多达 100 万聊天用户可在指定数量的子频道中自动平衡。弹性频道仅在 `ChimeSDKMessaging` 终端节点中可用。有关弹性频道的更多信息，请参阅本指南中的 [在 Amazon Chime SDK 消息传递中使用弹性频道举办实时事件](elastic-channels.md)。

**额外 APIs**  
Messaging 命`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_Messaging.html)。