遷移至亞馬遜編鐘 SDK 身分識別命名空間 - Amazon Chime SDK

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

遷移至亞馬遜編鐘 SDK 身分識別命名空間

Amazon Chime SDK 身分識別命名空間是用來建立和管理 Amazon Chime SDK 身分識別資源 (包括 AppInstances 和) 的 API 的專用位置。 AppInstanceUsers您可以使用命名空間來解決任何可用 AWS 區域中的 Amazon Chime SDK 身分識別 API 端點。如果您剛開始使用 Amazon Chime 開發套件,請使用此命名空間。如需有關「區域」的詳細資訊,請參閱本指南Amazon Chime SDK服務的可用AWS區域中的。

使用 Amazon Chime 命名空間的現有應用程式應計劃遷移到專用命名空間。

遷移的原因

基於下列原因,我們建議您移轉至 Amazon Chime SDK 身分識別名稱空間:

API 端點的選擇

Amazon Chime SDK 身分識別命名空間是唯一可以在任何提供 API 端點的區域中使用 API 端點的 API 命名空間。如果您想要使用以外的 API 端點us-east-1,則必須使用 Amazon Chime 開發套件身分識別命名空間。如需有關目前端點的詳細資訊,請參閱本指南API 映射中的〈〉。

更新和新的訊息 API

我們只會在 Amazon Chime SDK 身分識別命名空間中新增或更新身分識別 API。

移轉之前

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

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

命名空間之間的差異

以下各節說明ChimeChimeSDKIdentity命名空間之間的差異。

AWS SDK 命名空間

Amazon Chime SDK 命名空間使用Chime正式名稱。Amazon Chime SDK 身分識別命名空間會使用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 開發套件身分識別命名空間可以在任何可用的區域中處理 Amazon Chime SDK 身分識別 API 端點。如需目前端點「區域」清單,請參閱本指南Amazon Chime SDK服務的可用AWS區域中的〈〉。

端點

Amazon Chime 開發套件身分識別命名空間使用的 API 端點與 Amazon Chime 命名空間不同。

只有用於建立身分識別資源的端點可用於更新它們。這意味著通過中的端點 AppInstance 創建的只eu-central-1能通過修改eu-central-1。這也意味著您不能使用 ChimesdKiidty 命名空間來解決通過 Chime 命名空間 AppInstance 創建的問題us-east-1,也不能在創建和成員的區域以外的區域中創建通道。 AppInstance AppInstanceUser 如需有關目前端點的詳細資訊,請參閱本指南API 映射中的〈〉。

服務主體

Amazon Chime SDK 身分識別命名空間使用新的服務主體:Identity.chime.amazonaws.com。如果您有 SQS、SNS 或其他 IAM 存取政策授予服務存取權,則需要更新這些政策以授與新服務主體的存取權。

API

Amazon Chime SDK 身分識別命名空間僅包含用於建立和管理簡訊資源以及傳送和接收訊息的 API。Amazon Chime 命名空間包含適用於 Amazon Chime 服務其他部分的 API 以及簡訊。

使用者到期

建立時的到期設定可 AppInstanceUsers 讓您建立暫時使用者。例如,您可以建立只在大型廣播期間存在的聊天使用者。只有 Identity 命名空間支援的到期設定 AppInstanceUsers。

機器人

您可以使用 AppInstanceBotAPI 將採用 Amazon Lex V2 提供支援的聊天機器人新增到您的應用程式中。您只能在身份命名空間 AppInstanceBots 中使用。如需有關機器人的詳細資訊,請參閱本指南用 AppInstanceBots 作智慧型通路代理程式中的。

其他 API

身分識別名稱空間有不斷增加的其他 API 清單,而 Chime 命名空間沒有這些 API。如果您要開始使用 Amazon Chime 開發套件,請使用身分識別命名空間存取所有最新功能。如需有關目前 API 的詳細資訊,請參閱 Amazon Chime 開發套件 API 參考資料中的 Amazon Chime 開發套件識別