기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Connect Voice ID 스피커, 감시 목록, 사기범 관리 API
**참고**
지원 종료 알림: 2026년 5월 20일에 Amazon Connect Voice ID에 대한 지원이 AWS 종료됩니다. 2026년 5월 20일 이후에는 Amazon Connect 콘솔에서 Voice ID에 액세스하거나, Amazon Connect 관리자 웹 사이트 또는 연락처 제어판에서 Voice ID 기능에 액세스하거나, 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가 포함되어 있습니다. 모든 화자 API(`ListSpeakers` 제외)는 `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) 또는 [DisassociateFraudster](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): 지정된 감시 목록에서 사기범을 연결 해제합니다. 참고로, 사기범은 항상 적어도 하나 이상의 사기범 감시 목록에 연결되어 있어야 합니다. 사기범을 유일한 감시 목록에서 연결 해제하려고 하면 예외가 발생합니다.
사기범을 완전히 제거하려면 `DeleteFraudster`를 사용하세요.
1. [ListFraudsters](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListFraudsters.html): 도메인 또는 특정 감시 목록에 있는 모든 사기범을 나열합니다. 이 API는 사기범이 속해 있는 감시 목록도 반환합니다. API 요청에서 지정한 페이지 크기와 함께 페이지가 매겨진 출력을 반환합니다.