サポート終了通知: 2025 年 9 月 15 日、 AWS は Amazon Lex V1 のサポートを終了します。 V1 2025 年 9 月 15 日を過ぎると、Amazon Lex V1 コンソールまたは Amazon Lex V1 リソースにはアクセスできなくなります。Amazon Lex V2 を使用している場合は、代わりに [Amazon Lex V2 ガイド](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html)を参照してください。

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

# DeleteUtterances
<a name="API_DeleteUtterances"></a>

保存された発話を削除します。

Amazon Lex は、ユーザーがボットに送信する発話を保存します。発話は、[GetUtterancesView](API_GetUtterancesView.md) のオペレーションを使用するために15日間保存され、その後、ユーザーの入力に反応するボットの能力を向上させるために無期限に保存されます。

`DeleteUtterances` オペレーションを使用して、特定のユーザーの保存された発話を手動で削除します。`DeleteUtterances` オペレーションを行うと、ユーザーの入力に対するボットの応答能力を向上させるために保存されていた発話は、直ちに削除されます。`GetUtterancesView` オペレーションで使用するために保存された発話は 15 日後に削除されます。

このオペレーションには、`lex:DeleteUtterances` アクションに対する許可が必要です。

## リクエストの構文
<a name="API_DeleteUtterances_RequestSyntax"></a>

```
DELETE /bots/botName/utterances/userId HTTP/1.1
```

## URI リクエストパラメータ
<a name="API_DeleteUtterances_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [botName](#API_DeleteUtterances_RequestSyntax) **   <a name="lex-DeleteUtterances-request-uri-botName"></a>
発話を格納したボットの名前。  
長さの制限: 最小長は 2 です。最大長は 50 です。  
パターン: `^([A-Za-z]_?)+$`   
必須: はい

 ** [userId](#API_DeleteUtterances_RequestSyntax) **   <a name="lex-DeleteUtterances-request-uri-userId"></a>
 発話をしたユーザーの一意の識別子。これは、発話を含んだ [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html) または [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html) 操作リクエストで送信されたユーザー ID です。  
長さの制限: 最小長は 2 です。最大長は 100 です。  
必須: はい

## リクエストボディ
<a name="API_DeleteUtterances_RequestBody"></a>

リクエストにリクエスト本文がありません。

## レスポンスの構文
<a name="API_DeleteUtterances_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## レスポンス要素
<a name="API_DeleteUtterances_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 204 レスポンスを返します。

## エラー
<a name="API_DeleteUtterances_Errors"></a>

 ** BadRequestException **   
リクエストが適切にフォーマットされていません。例えば、値が無効であったり、必須項目が設定されていない場合です。フィールドの値を確認して、再度お試しください。  
HTTP ステータスコード: 400

 ** InternalFailureException **   
Amazon Lex 内部エラーが発生しました。リクエストを再試行してください。  
HTTP ステータスコード: 500

 ** LimitExceededException **   
リクエストが制限を超えました。リクエストを再試行してください。  
HTTP ステータスコード: 429

 ** NotFoundException **   
リクエストで指定されたリソースは見つかりませんでした。リソースを確認して、もう一度お試しください。  
HTTP ステータスコード: 404

## 以下の資料も参照してください。
<a name="API_DeleteUtterances_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteUtterances)