本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 遷移至 Amazon Chime SDK 訊息命名空間
<a name="messaging-namespace-migration"></a>

[Amazon Chime SDK Messaging](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) 命名空間是建立和管理 Amazon Chime SDK 訊息資源APIs 的專用位置。您可以使用 命名空間來處理任何可用 AWS 區域中的 Amazon Chime SDK 訊息 API 端點。如果您才剛開始使用 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 Messaging](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) 命名空間：

**API 端點的選擇**  
Amazon Chime SDK Messaging 命名空間是唯一可在任何[區域中使用 API 端點的 API ](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html)命名空間。如果您想要使用美國東部 （維吉尼亞北部） 以外的 API 端點，您必須使用 Amazon Chime SDK Messaging 命名空間。  
如需 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 Messaging 命名空間 | Amazon Chime 命名空間 | 
| --- | --- | --- | 
| AWS SDK 命名空間 | ChimeSDKMessaging | Chime | 
| 區域 | 多個 | 僅限美國東部 （維吉尼亞北部） | 
| API | 僅限用於傳訊APIs  | 用於傳訊和 Amazon Chime 其他部分的 APIs  | 
| 流程 | Available | 不適用 | 
| 彈性頻道 | Available | 不適用 | 

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

下列各節說明 `Amazon Chime`和 `Amazon Chime SDK Messaging`命名空間之間的差異。

**AWS SDK 命名空間**  
Amazon Chime SDK 命名空間使用`Chime`正式名稱。Amazon Chime SDK Messaging 命名空間使用`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 Messaging](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 Messaging](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) 命名空間使用新的服務主體：`messaging.chime.amazonaws.com`。如果您有授予服務存取權的 SQS、SNS 或其他 IAM 存取政策，則需要更新這些政策，以授予新服務主體存取權。

**API**  
[Amazon Chime SDK Messaging](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) 命名空間包含 Amazon Chime 服務其他部分的 APIs 以及簡訊。

**頻道流程**  
頻道流程可讓開發人員在傳輸中的訊息上執行商業邏輯，再交付給訊息頻道的成員。例如，您可以建立流程，在訊息傳遞前從訊息中移除敏感資料，例如政府 ID 號碼、電話號碼或褻瀆資料。這有助於實作公司通訊政策或其他通訊指導方針。

您也可以使用頻道流程來執行函數，例如在將結果傳回給參與者之前彙總輪詢的回應，或透過 SMS 傳送訊息。

頻道流程僅適用於 `ChimeSDKMessaging` 命名空間。如需有關它們的詳細資訊，請參閱本指南[使用頻道流程來處理 Amazon Chime SDK 訊息](using-channel-flows.md)中的 。

**彈性頻道**  
彈性管道支援大規模聊天體驗，最多可有 100 萬聊天使用者在定義的子通道數量之間自動平衡。彈性頻道只能在`ChimeSDKMessaging`端點中使用。如需彈性頻道的詳細資訊，請參閱本指南[使用彈性管道在 Amazon Chime SDK 會議中託管即時事件](elastic-channels.md)中的 。

**其他 APIs**  
訊息命名空間有不斷增長的 APIs 清單，而`Chime`命名空間沒有這些 API。如果您開始使用 Amazon Chime SDK，請使用簡訊命名空間來存取所有最新功能。如需目前 APIs的詳細資訊，請參閱《[Amazon Chime SDK API 參考](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html)*》中的 Amazon Chime SDK* 訊息。