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

遷移至 Amazon Chime SDK 語音命名空間

Amazon Chime SDK 語音命名空間是 APIs 的專用位置，可建立和管理 Amazon Chime SDK 語音資源。您可以使用 命名空間來處理任何 AWS 區域中可使用的 Amazon Chime SDK 語音 API 端點。如果您才剛開始使用 Amazon Chime SDK，請使用此命名空間。如需 區域的詳細資訊，請參閱本指南Amazon Chime SDK 的可用 AWS 區域中的 。

使用 Amazon Chime 命名空間的現有應用程式應計劃遷移到專用命名空間，以便使用更新的 APIs和新功能。

移轉原因

基於下列原因，我們建議您遷移至 Amazon Chime SDK Voice 命名空間：

遷移之前

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

如需可用區域的詳細資訊，請參閱 語音區域。

命名空間之間的差異

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

AWS 命名空間

Amazon Chime SDK 命名空間使用Chime正式名稱。Amazon Chime SDK Voice 命名空間使用ChimeSDKVoice正式名稱。名稱的精確格式因平台而異。

例如，如果您使用 Node.js 中的 AWS SDK 來建立會議，您可以使用下列程式碼行來定址命名空間。

const chimeVoice = AWS.Chime();

若要遷移至 Amazon Chime SDK Voice 命名空間，請使用新的命名空間和端點區域更新這行程式碼。

const chimeVoice = AWS.ChimeSDKVoice({ region: "eu-central-1" });

大區 (Regions)

Amazon Chime 命名空間只能處理us-east-1區域中的 API 端點。Amazon Chime SDK Voice 命名空間可以在任何可用區域中處理 Amazon Chime SDK 語音 API 端點。如需語音區域的最新清單，請參閱本指南Amazon Chime SDK 的可用 AWS 區域中的 。

端點

Amazon Chime SDK Voice 命名空間使用與 Amazon Chime 命名空間不同的 API 端點。

只有用來建立語音動作的端點可用於修改它。這表示透過 中的端點建立的語音動作eu-central-1只能透過 修改eu-central-1。這也表示您無法在 中使用 Chime 命名空間來處理透過 ChimeSDKVoice 命名空間建立的語音動作us-east-1。如需目前端點的詳細資訊，請參閱本指南API 映射中的 。

服務主體

這兩個命名空間都使用 chime.amazonaws.com服務主體。如果您有授予服務存取權的存取政策，則不需要更新這些政策。

API

Amazon Chime SDK Voice 命名空間僅包含用於建立和管理語音動作APIs。Amazon Chime 命名空間包含語音APIs 和 Amazon Chime 服務的其他部分，例如會議。

標記

只有 Amazon Chime SDK Voice 命名空間支援標籤。如需標籤的詳細資訊，請參閱 TagResource和 UntagResource。

媒體區域

如果您使用 Chime 命名空間來建立語音連接器和 SIP 媒體應用程式等資源，您只能在 us-east-1和 中執行此操作us-west-2，而且您必須使用us-east-1端點。

相反地，ChimeSDKVoice命名空間允許在所有支援的區域中建立資源，而不只是 us-east-1和 us-west-2。如需區域涵蓋範圍的詳細資訊，請參閱 Amazon Chime SDK 的可用 AWS 區域。