サポート終了通知: 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)を参照してください。翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # CreateIntentVersion `$LATEST` バージョンのインテントに基づいて、インテントの新しいバージョンを作成します。`$LATEST` バージョンのインテントの最後の更新から変更がない場合、Amazon Lex は新しいバージョンを作成しません。最後に作成したバージョンを返します。 **注記** `$LATEST` バージョンのインテントのみアップデートすることができます。`CreateIntentVersion` オペレーションを使用して作成した番号付きのバージョンを更新することはできません。ボットの最初のバージョンを作成すると、Amazon Lex はバージョンを 1 に設定します。それ以降のバージョンは 1 ずつ増えます。詳細については、「[バージョニング](versioning-aliases.md#versioning-intro)」を参照してください。このオペレーションには `lex:CreateIntentVersion` アクションを実行するアクセス許可が必要です。 ## リクエストの構文 ``` POST /intents/name/versions HTTP/1.1 Content-type: application/json { "checksum": "string" } ``` ## URI リクエストパラメータリクエストでは、次の URI パラメータを使用します。 ** [name](#API_CreateIntentVersion_RequestSyntax) ** 新しいバージョンを作成するインテントの名前。名前は、大文字と小文字が区別されます。長さの制限：最小長 1、最大長は 100 です。パターン: `^([A-Za-z]_?)+$` 必須: はい ## リクエストボディリクエストは以下の JSON 形式のデータを受け入れます。 ** [checksum](#API_CreateIntentVersion_RequestSyntax) ** 新しいバージョンの作成に使用する `$LATEST` バージョンのインテントのチェックサム。チェックサムを指定しても、`$LATEST` バージョンのインテントのチェックサムが異なる場合、Amazon Lex は `PreconditionFailedException` の例外を返し、新しいバージョンを公開しません。チェックサムを指定しない場合、Amazon Lex は `$LATEST` バージョンを公開します。タイプ: 文字列必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 201 Content-type: application/json { "checksum": "string", "conclusionStatement": { "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" }, "confirmationPrompt": { "maxAttempts": number, "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" }, "createdDate": number, "description": "string", "dialogCodeHook": { "messageVersion": "string", "uri": "string" }, "followUpPrompt": { "prompt": { "maxAttempts": number, "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" }, "rejectionStatement": { "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" } }, "fulfillmentActivity": { "codeHook": { "messageVersion": "string", "uri": "string" }, "type": "string" }, "inputContexts": [ { "name": "string" } ], "kendraConfiguration": { "kendraIndex": "string", "queryFilterString": "string", "role": "string" }, "lastUpdatedDate": number, "name": "string", "outputContexts": [ { "name": "string", "timeToLiveInSeconds": number, "turnsToLive": number } ], "parentIntentSignature": "string", "rejectionStatement": { "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" }, "sampleUtterances": [ "string" ], "slots": [ { "defaultValueSpec": { "defaultValueList": [ { "defaultValue": "string" } ] }, "description": "string", "name": "string", "obfuscationSetting": "string", "priority": number, "responseCard": "string", "sampleUtterances": [ "string" ], "slotConstraint": "string", "slotType": "string", "slotTypeVersion": "string", "valueElicitationPrompt": { "maxAttempts": number, "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" } } ], "version": "string" } ``` ## レスポンス要素アクションが成功すると、HTTP 201 レスポンスが返されます。サービスから以下のデータが JSON 形式で返されます。 ** [checksum](#API_CreateIntentVersion_ResponseSyntax) ** 作成されたインテントバージョンのチェックサム。タイプ: 文字列 ** [conclusionStatement](#API_CreateIntentVersion_ResponseSyntax) ** `fulfillmentActivity` フィールドで指定された Lambda 関数がインテントを達成すると、Amazon Lex はこのステートメントをユーザーに伝えます。型: [Statement](API_Statement.md) オブジェクト ** [confirmationPrompt](#API_CreateIntentVersion_ResponseSyntax) ** これが定義されている場合、Amazon Lex がユーザーのインテントを達成する前の確認に使用するプロンプトです。型: [Prompt](API_Prompt.md) オブジェクト ** [createdDate](#API_CreateIntentVersion_ResponseSyntax) ** インテントが作成された日付。型: タイムスタンプ ** [description](#API_CreateIntentVersion_ResponseSyntax) ** インテントの説明。タイプ: 文字列長さの制約: 最小長は 0 です。最大長は 200 です。 ** [dialogCodeHook](#API_CreateIntentVersion_ResponseSyntax) ** これが定義されている場合、Amazon Lex は各ユーザー入力に対してこの Lambda 関数を呼び出します。型: [CodeHook](API_CodeHook.md) オブジェクト ** [followUpPrompt](#API_CreateIntentVersion_ResponseSyntax) ** これが定義されている場合、Amazon Lex はこのプロンプトを使用して、インテントが達成された後に追加のユーザーアクティビティを要求します。型: [FollowUpPrompt](API_FollowUpPrompt.md) オブジェクト ** [fulfillmentActivity](#API_CreateIntentVersion_ResponseSyntax) ** インテントがどのように達成されるのかを説明します。型: [FulfillmentActivity](API_FulfillmentActivity.md) オブジェクト ** [inputContexts](#API_CreateIntentVersion_ResponseSyntax) ** Amazon Lex がユーザーとの会話の中でインテントを選択するためのアクティブなコンテキストをリストアップした `InputContext` オブジェクトの配列です。型: [InputContext](API_InputContext.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 5 項目です。 ** [kendraConfiguration](#API_CreateIntentVersion_ResponseSyntax) ** Amazon Kendra インデックスと `AMAZON.KendraSearchIntent` インテントを接続するための設定情報 (項目がある場合)。型: [KendraConfiguration](API_KendraConfiguration.md) オブジェクト ** [lastUpdatedDate](#API_CreateIntentVersion_ResponseSyntax) ** インテントが更新された日付。型: タイムスタンプ ** [name](#API_CreateIntentVersion_ResponseSyntax) ** インテントの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 100 です。パターン: `^([A-Za-z]_?)+$` ** [outputContexts](#API_CreateIntentVersion_ResponseSyntax) ** `OutputContext` オブジェクトの配列で、インテントが達成されたときにアクティブになるコンテキストを列挙します。型: [OutputContext](API_OutputContext.md) オブジェクトの配列の配列メンバー: 最小数は 0 項目です。最大数は 10 項目です。 ** [parentIntentSignature](#API_CreateIntentVersion_ResponseSyntax) ** 組み込みインテントの一意の識別子。タイプ: 文字列 ** [rejectionStatement](#API_CreateIntentVersion_ResponseSyntax) ** ユーザーが `confirmationPrompt` で定義された質問に「いいえ」と答えた場合、Amazon Lex はインテントがキャンセルされたことを確認するためにこのステートメントを返します。型: [Statement](API_Statement.md) オブジェクト ** [sampleUtterances](#API_CreateIntentVersion_ResponseSyntax) ** インテント用に構成されたサンプル発話の配列。型: 文字列の配列配列メンバー: 最小数は 0 項目です。最大数は 1500 項目です。長さの制限：最小長 1、最大長は 200 です。 ** [slots](#API_CreateIntentVersion_ResponseSyntax) ** インテントを達成するために必要な情報を定義するスロットタイプの配列。型: [Slot](API_Slot.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 100 項目です。 ** [version](#API_CreateIntentVersion_ResponseSyntax) ** インテントの新しいバージョンに割り当てられたバージョン番号。タイプ: 文字列長さの制約: 最小長は 1 です。最大長 64 パターン: `\$LATEST|[0-9]+` ## エラー ** BadRequestException ** リクエストが適切にフォーマットされていません。例えば、値が無効であったり、必須項目が設定されていない場合です。フィールドの値を確認して、再度お試しください。 HTTP ステータスコード: 400 ** ConflictException ** リクエストの処理中に競合が発生しました。リクエストを再試行してください。 HTTP ステータスコード: 409 ** InternalFailureException ** Amazon Lex 内部エラーが発生しました。リクエストを再試行してください。 HTTP ステータスコード: 500 ** LimitExceededException ** リクエストが制限を超えました。リクエストを再試行してください。 HTTP ステータスコード: 429 ** NotFoundException ** リクエストで指定されたリソースは見つかりませんでした。リソースを確認して、もう一度お試しください。 HTTP ステータスコード: 404 ** PreconditionFailedException ** 変更しようとしているリソースのチェックサムがリクエストのチェックサムと一致しません。リソースのチェックサムを確認して、もう一度お試しください。 HTTP ステータスコード: 412 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateIntentVersion) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateIntentVersion) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateIntentVersion) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateIntentVersion) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateIntentVersion) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateIntentVersion) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateIntentVersion) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateIntentVersion) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateIntentVersion) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateIntentVersion)