本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

**注意**  
终止支持通知：2026年5月20日， AWS 将终止对Amazon Connect语音识别的支持。2026 年 5 月 20 日之后，您将无法再访问 Amazon Connect 控制台上的语音 ID、访问 Amazon Connect 管理网站或联系人控制面板上的语音识别功能，也无法访问语音 ID 资源。有关更多信息，请访问 [Amazon Connect Voice ID 支持终止](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。

Amazon Connect 语音识别允许您管理语音识别域名。 APIs 您可以在控制台中找到 “创建”、“描述”、“列出” 和 “更新” 的 AWS 等效项。

1. [CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html)：要创建新的语音 ID 域，请使用`CreateDomain`语音 ID API。创建 Voice ID 域后，会同时创建一个默认的欺诈者监视列表来控制您的欺诈者。

   使用 `CreateDomain` API 时，请注意以下指导原则：
   +  只有在 AWS 控制台中确认 BIPA 同意后，您才能为自己的账户调用此功能。
   +  您还必须在创建 Voice ID 域时为其指定 KMS 密钥。
   + 创建语音 ID 域后，使用 [Amazon Connect 关联 APIs](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 实例关联，则 Voice ID API 调用和 Voice ID 流数据块将返回运行时错误。删除 Voice 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 密钥了。