本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# Amazon Connect 语音 ID 扬声器、关注列表和欺诈者管理 APIs
**注意**
终止支持通知：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 语音 ID 包括 APIs 管理注册到语音 ID 域的演讲者和在该域中注册的欺诈者。除外 APIs`ListSpeakers`，所有发言者均接受`CustomerSpeakerId`或`GeneratedSpeakerId`。
## 扬声器管理 APIs
1. [DescribeSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeSpeaker.html)：描述演讲者在[域中的状态（已注册、OPTED\$1OUT、EXPIRED）](voiceid-domain.md#voiceid-speaker-enrollments)，然后将 a 映射`GeneratedSpeakerId`到 a`CustomerSpeakerId`，反之亦然。
1. [DeleteSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteSpeaker.html)： caller/speaker 从语音 ID 域中完全移除所有记录。所有声纹和注册状态将立即删除，关联的录音将在 24 小时内删除。
1. [ListSpeakers](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListSpeakers.html)：列出其条目出现在语音识别域中的所有发言者。此 API 会同时返回呼叫方的 `CustomerSpeakerId` 和 `GeneratedSpeakerId`。它会按照 API 请求中规定的页面大小返回分页输出。
1. [OptOutSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_OptOutSpeaker.html)：从语音 ID 域中退出来电者。此 API 不要求呼叫方出现在 Voice ID 中。使用此 API 可以选择退出不存在的呼叫方，Voice ID 会保持选择退出状态，并拒绝未来对该呼叫方的注册请求。选择退出还会删除该呼叫方的声纹和所有存储的录音。
## 监视列表管理 APIs
1. [CreateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html): 创建欺诈者可以参与的监视名单。
1. [DeleteWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteWatchlist.html): 从 Voice ID 域中移除自定义欺诈者监视列表。要删除监视列表，该列表必须为空。也就是说，它不得有任何与之相关的欺诈者。您可以使用[DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html)或[DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html) APIs 将所有欺诈者从监视列表中删除。
您不能从 Voice ID 域中删除默认监视列表。
1. [DescribeWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeWatchlist.html)：确定它是默认的欺诈者监视列表，还是您创建的自定义监视列表，并获取监视列表详细信息。
1. [ListWatchlists](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListWatchlists.html): 列出语音 ID 域中的所有关注列表。
1. [UpdateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateWatchlist.html)：更新自定义欺诈者监视列表的名称和描述。您无法修改默认监视列表的详细信息，因为它由 Voice ID 管理。
## 欺诈者管理 APIs
1. [AssociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_AssociateFraudster.html): 将欺诈者关联到同一域中的监视列表。您可以将欺诈者关联到一个域中的多个监视列表。
1. [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html): 从语音 ID 域中删除欺诈者。删除欺诈者会将该欺诈者从其所属的所有监视列表中删除。还会在 24 小时内删除所有声纹和相关的录音。
1. [DescribeFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeFraudster.html): 描述欺诈者在语音 ID 域中的状态。
1. [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html): 取消欺诈者与指定监视名单的关联。请注意，欺诈者必须至少与一个欺诈者监视列表相关联；如果您尝试取消欺诈者与其唯一监视列表的关联，则会引发异常。
要完全移除欺诈者，请使用 `DeleteFraudster`。
1. [ListFraudsters](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListFraudsters.html): 列出某个域名或特定监视列表中的所有欺诈者。此 API 还会返回欺诈者所属的监视名单。它会按照 API 请求中规定的页面大小返回分页输出。