

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

# 管理 Amazon Connect Voice ID 網域
<a name="voiceid-domain-operations"></a>

**注意**  
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。

Amazon Connect Voice ID 為您提供用於管理語音 ID 網域的 API。您可以在 AWS 主控台中找到建立、描述、列出和更新的對等項目。

1. [CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html)：若要建立新的語音 ID 網域，請使用 `CreateDomain` 語音 ID API。建立 Voice ID 網域後，系統會同時建立預設的詐騙者監視清單，以保留您的詐騙者。

   使用 `CreateDomain` API 時，請注意下列指導方針：
   +  只有在您在 AWS 主控台中確認 BIPA 同意後，才能叫用您的帳戶。
   +  您也必須在建立時指定語音 ID 網域的 KMS 金鑰。
   + 建立語音 ID 網域後，請使用 [Amazon Connect 關聯 API](https://docs.aws.amazon.com/connect/latest/APIReference/) 將其與 Amazon Connect 執行個體建立關聯。

1.  [DeleteDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteDomain.html)：若要刪除語音 ID 網域，您必須調用 `DeleteDomain` 語音 ID API 並提供網域 ID。如果此網域與 Amazon Connect 執行個體相關聯，語音 ID API 呼叫和語音 ID 流程區塊將傳回執行期錯誤。刪除語音 ID 網域會刪除所有儲存的客戶資料，例如錄音、聲紋和發言者識別碼，以及您管理的詐騙者名單。

1. [DescribeDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeDomain.html)：使用此 API 傳回由 `DomainID` 識別的現有網域的名稱，描述和加密配置。

1. [ListDomains](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListDomains.html)：使用此 API 列出您在該地區帳戶擁有的所有語音 ID 網域。

1.  [UpdateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateDomain.html)：若要更新網域的名稱和加密設定，您可以使用 `UpdateDomain` 語音 ID API。此 API 會破壞現有屬性，而且您必須同時提供這兩個欄位。

   當您變更與 Voice ID 網域相關聯的 KMS 金鑰時，在 `UpdateDomain` 呼叫之後，網域的現有資料將在新的 KMS 金鑰下以非同步方式重新加密。您可以使用 `DescribeDomain` API 從網域的 `ServerSideEncryptionUpdateDetails` 屬性中檢查此過程的狀態。此更新程序正在進行中時，您必須將舊 KMS 金鑰保留在可存取的狀態，否則此程序可能會失敗。完成此程序之後，舊的 KMS 金鑰可能會安全淘汰。