翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Connect Voice ID ドメインの管理
<a name="voiceid-domain-operations"></a>

**注記**  
サポート終了通知: 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 が用意されています。作成、説明、一覧表示、更新の同等物は、 AWS コンソールで確認できます。

1. [CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html): 新しい Voice ID ドメインを作成するには、`CreateDomain` Voice ID API を使用します。Voice ID ドメインが作成されると、不正行為者を保持するデフォルトの不正行為者ウォッチリストが同時に作成されます。

   `CreateDomain` API を使用するときには、以下のガイドラインに注意してください。
   +  これを呼び出すことができるのは、 AWS コンソールで BIPA 同意を確認した後のみです。
   +  作成時に Voice ID ドメインの KMS キーも指定する必要があります。
   + Voice 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): Voice ID ドメインを削除するには、`DeleteDomain` Voice 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 を使用して、リージョン内のアカウントが所有するすべての Voice ID ドメインをリストします。

1.  [UpdateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateDomain.html): ドメインの名前と暗号化の設定を更新するには、`UpdateDomain` Voice ID API を使用します。この API は既存の属性を破棄するため、これらの両方のフィールドを指定する必要があります。

   Voice ID ドメインに関連付けられている KMS キーを変更すると、`UpdateDomain` の呼び出しの後で、ドメインの既存のデータは新しい KMS キーで非同期的に再暗号化されます。このプロセスのステータスは、`DescribeDomain` API を使用して、ドメインの `ServerSideEncryptionUpdateDetails` 属性で確認できます。この更新プロセスの進行中は、古い KMS キーをアクセス可能な状態に維持する必要があります。そうしないと、このプロセスが失敗する可能性があります。このプロセスが完了すると、古い KMS キーを安全に廃止できます。