本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
遷移至 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 命名空間:
遷移之前
遷移之前,請注意命名空間之間的差異。下表列出並說明它們。
| Amazon Chime SDK 身分命名空間 | 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。Amazon Chime 命名空間包含 Amazon Chime 服務其他部分的 APIs 以及簡訊。
使用者過期
建立 AppInstanceUsers 時的過期設定可讓您建立臨時使用者。例如,您可以建立只在大型廣播期間存在的聊天使用者。只有身分命名空間支援 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。