サポート終了通知: 2025 年 9 月 15 日、 AWS は Amazon Lex V1 のサポートを終了します。 V1 2025 年 9 月 15 日以降、Amazon Lex V1 コンソールまたは Amazon Lex V1 リソースにアクセスできなくなります。Amazon Lex V2 を使用している場合は、代わりに Amazon Lex V2 ガイドを参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
DeleteBot
$LATEST バージョンを含む、すべてのバージョンのボットを削除します。特定のバージョンのボットを削除するには、DeleteBotVersion オペレーションを行います。DeleteBot のオペレーションでは、ボットのスキーマはすぐには削除されません。その代わり、削除マークをつけておき、後で削除します。
Amazon Lex は、ユーザーの入力に対するボットの応答能力を向上させるために、発話を無期限に保存します。これらの発話は、ボットが削除されても削除されません。発話を削除するには、DeleteUtterances オペレーションを使用します。
ボットにエイリアスがある場合、削除することはできません。その代わり、DeleteBot オペレーションは、ボットを参照するエイリアスへの参照を含む ResourceInUseException 例外を返します。ボットへの参照を削除するには、エイリアスを削除します。同じ例外が再び発生した場合は、DeleteBot オペレーションが成功するまで、参照元のエイリアスを削除してください。
このオペレーションには、lex:DeleteBot アクションに対する許可が必要です。
リクエストの構文
DELETE /bots/name HTTP/1.1
URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- name
-
ボットの名前。名前は、大文字と小文字が区別されます。
長さの制限: 最小長は 2 です。最大長は 50 です。
Pattern:
^([A-Za-z]_?)+$必須: はい
リクエストボディ
リクエストにリクエスト本文がありません。
レスポンスの構文
HTTP/1.1 204
レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 204 レスポンスを返します。
エラー
- BadRequestException
-
リクエストが適切にフォーマットされていません。例えば、値が無効であったり、必須項目が設定されていない場合です。フィールドの値を確認して、再度お試しください。
HTTP ステータスコード: 400
- ConflictException
-
リクエストの処理中に競合が発生しました。リクエストを再試行してください。
HTTP ステータスコード: 409
- InternalFailureException
-
Amazon Lex 内部エラーが発生しました。リクエストを再試行してください。
HTTP ステータスコード: 500
- LimitExceededException
-
リクエストが制限を超えました。リクエストを再試行してください。
HTTP ステータスコード: 429
- NotFoundException
-
リクエストで指定されたリソースは見つかりませんでした。リソースを確認して、もう一度お試しください。
HTTP ステータスコード: 404
- ResourceInUseException
-
削除しようとしているリソースは、別のリソースによって参照されています。この情報を使用して、削除するリソースへの参照を解除します。
例外の本文には、リソースを記述する JSON オブジェクトが含まれています。
{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,"resourceReference": {"name": string, "version": string } }HTTP ステータスコード: 400
以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
