翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Connect Voice ID の発話者、ウォッチリスト、および不正行為者管理 API
**注記**
サポート終了通知: 2026 年 5 月 20 日、 AWS は Amazon Connect Voice ID のサポートを終了します。2026 年 5 月 20 日以降、Amazon Connect コンソールの Voice ID にアクセスしたり、管理者ウェブサイトまたは問い合わせコントロールパネルの Voice ID Amazon Connect 機能にアクセスしたり、Voice ID リソースにアクセスしたりできなくなります。詳細については、「[Amazon Connect Voice ID のサポート終了](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)」を参照してください。
Amazon Connect Voice ID には、Voice ID ドメインに登録された発話者と、ドメインに登録されている不正行為者を管理するための API が含まれています。`ListSpeakers` を除くすべての発話者 API は `CustomerSpeakerId` または `GeneratedSpeakerId` を受け入れます。
## 発話者管理 API
1. [DescribeSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeSpeaker.html): 発話者の[ドメイン内のステータス (ENROLLED、OPTED\$1OUT、EXPIRED)](voiceid-domain.md#voiceid-speaker-enrollments) を記述し、`GeneratedSpeakerId` を `CustomerSpeakerId` にマッピングするとともに、その逆にもマッピングします。
1. [DeleteSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteSpeaker.html): Voice ID ドメインから発信者/発話者のすべてのレコードを完全に削除します。すべての声紋と登録ステータスはすぐに削除され、関連する録音は 24 時間以内に削除されます。
1. [ListSpeakers](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListSpeakers.html): Voice ID ドメインにエントリが存在するすべての発話者を一覧表示します。この API は、発話者の `CustomerSpeakerId` と `GeneratedSpeakerId` の両方を返します。API リクエストで指定されたページサイズでページ分割された出力を返します。
1. [OptOutSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_OptOutSpeaker.html): Voice ID ドメインから発信者をオプトアウトします。この API では、発話者が Voice ID に存在する必要はありません。この API を使用して存在しない発話者をオプトアウトできます。そうすると、Voice ID はオプトアウトされたステータスを保持し、この発話者に対する今後の登録要求を拒否します。オプトアウトすると、この発信者の声紋と保存された録音も削除されます。
## ウォッチリスト管理 API
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) または [DissociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html) API を使用して、ウォッチリストからすべての不正行為者を削除できます。
デフォルトのウォッチリストを 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): Voice ID ドメイン内のすべてのウォッチリストを一覧表示します。
1. [UpdateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateWatchlist.html): カスタム不正行為者ウォッチリストの名前と説明を更新します。デフォルトのウォッチリストは Voice ID によって管理されているため、詳細を変更することはできません。
## 不正行為者管理 API
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): Voice ID ドメインから不正行為者を削除します。不正行為者を削除すると、その不正行為者が属しているすべてのウォッチリストから削除されます。また、すべての声紋と、関連付けられたオーディオ録音が 24 時間以内に削除されます。
1. [DescribeFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeFraudster.html): Voice ID ドメイン内の不正行為者のステータスを記述します。
1. [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html): 指定したウォッチリストから不正行為者の関連付けを解除します。ただし、不正行為者は常に少なくとも 1 つのウォッチリストに関連付けられている必要があります。唯一のウォッチリストから不正行為者の関連付けを解除しようとすると、例外がスローされます。
不正行為者師を完全に排除するには、`DeleteFraudster` を使用してください。
1. [ListFraudsters](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListFraudsters.html): ドメインまたは特定のウォッチリスト内のすべての不正行為者を一覧表示します。この API は、不正行為者が属しているウォッチリストも返します。API リクエストで指定されたページサイズでページ分割された出力を返します。