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

# 遷移至 Amazon Chime SDK 身分命名空間
<a name="identity-namespace-migration"></a>

[Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) 命名空間是用於建立和管理 Amazon Chime SDK 身分資源APIs 的專用位置，包括 AppInstances 和 AppInstanceUsers。您可以使用 命名空間來處理任何可用 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**
+ [遷移原因](#identity-migration-reasons)
+ [遷移之前](#id-before-migrating)
+ [命名空間之間的差異](#id-namespace-differences)

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

基於下列原因，建議您遷移至 [Amazon Chime SDK Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) 命名空間：

**API 端點的選擇**  
Amazon Chime SDK Identity 命名空間是唯一可在任何[區域中使用 API 端點的 API ](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html)命名空間。如果您想要使用 以外的 API 端點`us-east-1`，則必須使用 Amazon Chime SDK Identity 命名空間。如需目前端點的詳細資訊，請參閱本指南[API 映射](migrate-from-chm-namespace.md#name-end-map)中的 。

**已更新和新的訊息 APIs**  
我們只在 Amazon Chime SDK Identity 命名空間中新增或更新身分 APIs。

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

遷移之前，請注意命名空間之間的差異。下表列出並說明它們。


|  | Amazon Chime SDK Identity 命名空間 | Amazon Chime 命名空間 | 
| --- | --- | --- | 
| AWS SDK 命名空間 | ChimeSDKIdentity | Chime | 
| 區域 | 多個 | 僅限 us-east-1 | 
| 服務主體 | https://identity.chime.amazonaws.com | https://chime.amazonaws.com | 
| API | 只有用於身分APIs  | Amazon Chime 身分和其他部分的 APIs  | 
| 使用者過期 | 可用性 | 無 | 
| 機器人 | 可用性 | 無 | 

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

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

**AWS SDK 命名空間**  
Amazon Chime SDK 命名空間使用`Chime`正式名稱。Amazon Chime SDK Identity 命名空間使用`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 Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) 命名空間可以在任何可用區域中處理 Amazon Chime SDK Identity API 端點。如需最新的端點區域清單，請參閱本指南[Amazon Chime SDK 的可用 AWS 區域](sdk-available-regions.md)中的 。

**端點**  
[Amazon Chime SDK Identity](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`。這也表示您無法在 中使用 ChimeSDKIdentity 命名空間處理透過 Chime 命名空間建立的 AppInstance`us-east-1`，或在建立 AppInstance 和 AppInstanceUser 成員的區域以外的區域中建立頻道。如需目前端點的詳細資訊，請參閱本指南[API 映射](migrate-from-chm-namespace.md#name-end-map)中的 。

**服務主體**  
[Amazon Chime SDK Identity](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 Identity](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) 命名空間僅包含用於建立和管理訊息資源的 APIs，以及用於傳送和接收訊息的 API。[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 命名空間包含 Amazon Chime 服務其他部分的 APIs 以及訊息。

**使用者過期**  
建立 AppInstanceUsers 時的過期設定可讓您建立臨時使用者。例如，您可以建立只在大型廣播期間存在的聊天使用者。只有 Identity 命名空間支援 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 支援的聊天機器人新增至您的應用程式。您只能在 Identity 命名空間中使用 AppInstanceBots。如需機器人的詳細資訊，請參閱本指南[使用 AppInstanceBots 做為 Amazon Chime SDK 訊息的智慧型頻道代理程式](appinstance-bots.md)中的 。

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