Amazon Connect Voice ID ドメインの管理 - Amazon Connect

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

Amazon Connect Voice ID ドメインの管理

注記

サポート終了のお知らせ: 2026 年 5 月 20 日をもって、AWS は Amazon Connect Voice ID のサポートを終了します。2026 年 5 月 20 日を過ぎると、Amazon Connect コンソールでの Voice ID へのアクセス、Amazon Connect 管理ウェブサイトまたは問い合わせコントロールパネルでの Voice ID 機能へのアクセス、Voice ID リソースへのアクセスはできなくなります。詳細については、「Amazon Connect Voice ID のサポート終了」を参照してください。

Amazon Connect Voice ID には、Voice ID ドメインを管理するための API が用意されています。AWS コンソールでの [作成]、[更新]、[説明]、[リスト] と同等のものがあります。

  1. CreateDomain: 新しい Voice ID ドメインを作成するには、CreateDomain Voice ID API を使用します。Voice ID ドメインが作成されると、不正行為者を保持するデフォルトの不正行為者ウォッチリストが同時に作成されます。

    CreateDomain API を使用するときには、以下のガイドラインに注意してください。

    • これは、AWS コンソールで BIPA 同意を確認した後でのみ、アカウントに対して呼び出すことができます。

    • 作成時に Voice ID ドメインの KMS キーも指定する必要があります。

    • Voice ID ドメインを作成したら、Amazon Connect アソシエーション API を使用して、Amazon Connect インスタンスに関連付けます。

  2. DeleteDomain: Voice ID ドメインを削除するには、DeleteDomain Voice ID API を呼び出し、ドメイン ID を指定します。このドメインが Amazon Connect インスタンスに関連付けられている場合、Voice ID API コールと Voice ID フローブロックはランタイムエラーを返します。Voice ID ドメインを削除すると、録音、声紋、発話者識別子などの保存された顧客データ、および管理している不正行為者リストがすべて削除されます。

  3. DescribeDomain: この API を使用して、DomainID で特定した既存のドメインの名前、説明、暗号化設定を返します。

  4. ListDomains: この API を使用して、リージョン内のアカウントが所有するすべての Voice ID ドメインをリストします。

  5. UpdateDomain: ドメインの名前と暗号化の設定を更新するには、UpdateDomain Voice ID API を使用します。この API は既存の属性を破棄するため、これらの両方のフィールドを指定する必要があります。

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