本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
遷移至 Amazon Chime SDK 身分命名空間
Amazon Chime SDK Identity 命名空間是用於建立和管理 Amazon Chime SDK 身分資源APIs 的專用位置，包括 AppInstances 和 AppInstanceUsers。您可以使用 命名空間來處理任何可用 AWS 區域中的 Amazon Chime SDK 身分 API 端點。如果您剛開始使用 Amazon Chime SDK，請使用此命名空間。如需區域的詳細資訊，請參閱本指南Amazon Chime SDK 的可用 AWS 區域中的 。
使用 Amazon Chime 命名空間的現有應用程式應計劃遷移到專用命名空間。
遷移原因
基於下列原因，建議您遷移至 Amazon Chime SDK Identity 命名空間：
- API 端點的選擇
-
Amazon Chime SDK Identity 命名空間是唯一可在任何區域中使用 API 端點的 API 命名空間。如果您想要使用 以外的 API 端點
us-east-1，則必須使用 Amazon Chime SDK Identity 命名空間。如需目前端點的詳細資訊，請參閱本指南API 映射中的 。 - 已更新和新的訊息 APIs
-
我們只在 Amazon Chime SDK Identity 命名空間中新增或更新身分 APIs。
遷移之前
遷移之前，請注意命名空間之間的差異。下表列出並說明它們。
| 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 |
| 使用者過期 | 可用性 | 無 |
| 機器人 | 可用性 | 無 |
命名空間之間的差異
下列各節說明 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 命名空間只能處理 us-east-1 區域中的 API 端點。Amazon Chime SDK Identity 命名空間可以在任何可用區域中處理 Amazon Chime SDK Identity API 端點。如需最新的端點區域清單，請參閱本指南Amazon Chime SDK 的可用 AWS 區域中的 。
端點
Amazon Chime SDK Identity 命名空間使用與 Amazon Chime 命名空間不同的 API 端點。
只有用來建立身分資源的端點才能用來更新。這表示透過 中的端點建立的 AppInstance eu-central-1 只能透過 修改eu-central-1。這也表示您無法在 中使用 ChimeSDKIdentity 命名空間處理透過 Chime 命名空間建立的 AppInstanceus-east-1，或在建立 AppInstance 和 AppInstanceUser 成員的區域以外的區域中建立頻道。如需目前端點的詳細資訊，請參閱本指南API 映射中的 。
服務主體
Amazon Chime SDK Identity 命名空間使用新的服務主體：Identity.chime.amazonaws.com。如果您有授予服務存取權的 SQS、SNS 或其他 IAM 存取政策，則需要更新這些政策，以授予新服務主體存取權。
API
Amazon Chime SDK Identity 命名空間僅包含用於建立和管理訊息資源的 APIs，以及用於傳送和接收訊息的 API。Amazon Chime 命名空間包含 Amazon Chime 服務其他部分的 APIs 以及訊息。
使用者過期
建立 AppInstanceUsers 時的過期設定可讓您建立臨時使用者。例如，您可以建立只在大型廣播期間存在的聊天使用者。只有 Identity 命名空間支援 AppInstanceUsers 的過期設定。
機器人
您可以使用 AppInstanceBot API 將 Amazon Lex V2 支援的聊天機器人新增至您的應用程式。您只能在 Identity 命名空間中使用 AppInstanceBots。如需機器人的詳細資訊，請參閱本指南使用 AppInstanceBots 做為 Amazon Chime SDK 訊息的智慧管道代理程式中的 。
其他 APIs
Identity 命名空間有越來越多的 Chime 命名空間沒有的其他 APIs 清單。如果您開始使用 Amazon Chime SDK，請使用 Identity 命名空間來存取所有最新功能。如需目前 APIs的詳細資訊，請參閱《Amazon Chime SDK API 參考》中的 Amazon Chime SDK Identity。
