サポート終了通知: 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)を参照してください。翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # PutBotAlias 指定されたバージョンのボットのエイリアスを作成したり、指定されたボットのエイリアスを置き換えたりします。エイリアスが示すボットのバージョンを変更するには、エイリアスを置き換えます。エイリアスの詳細については、「[バージョニングとエイリアス](versioning-aliases.md)」を参照してください。このオペレーションには、`lex:PutBotAlias` アクションに対する許可が必要です。 ## リクエストの構文 ``` PUT /bots/botName/aliases/name HTTP/1.1 Content-type: application/json { "botVersion": "string", "checksum": "string", "conversationLogs": { "iamRoleArn": "string", "logSettings": [ { "destination": "string", "kmsKeyArn": "string", "logType": "string", "resourceArn": "string" } ] }, "description": "string", "tags": [ { "key": "string", "value": "string" } ] } ``` ## URI リクエストパラメータリクエストでは、次の URI パラメータを使用します。 ** [botName](#API_PutBotAlias_RequestSyntax) ** ボットの名前。長さの制限: 最小長は 2 です。最大長は 50 です。パターン: `^([A-Za-z]_?)+$` 必須: はい ** [name](#API_PutBotAlias_RequestSyntax) ** エイリアスの名前。キースペース名では、大文字と小文字は区別*されません*。長さの制限：最小長 1、最大長は 100 です。パターン: `^([A-Za-z]_?)+$` 必須: はい ## リクエストボディリクエストは以下の JSON 形式のデータを受け入れます。 ** [botVersion](#API_PutBotAlias_RequestSyntax) ** ボットのバージョン。タイプ: 文字列長さの制約: 最小長は 1 です。最大長 64 パターン: `\$LATEST|[0-9]+` 必須: はい ** [checksum](#API_PutBotAlias_RequestSyntax) ** `$LATEST` バージョンの特定のリビジョンを識別します。新しいボットエイリアスを作成する場合は、`checksum` フィールドを空白にします。チェックサムを指定した場合、`BadRequestException` の例外が発生します。ボットエイリアスを更新する場合は、`checksum` フィールドに `$LATEST` バージョンの最新リビジョンのチェックサムを設定します。` checksum` フィールドを指定しない場合や、チェックサムが `$LATEST` バージョンと一致しない場合は、`PreconditionFailedException` 例外が発生します。タイプ: 文字列必須: いいえ ** [conversationLogs](#API_PutBotAlias_RequestSyntax) ** エイリアスの会話ログの設定。型: [ConversationLogsRequest](API_ConversationLogsRequest.md) オブジェクト必須: いいえ ** [description](#API_PutBotAlias_RequestSyntax) ** エイリアスの説明。型: 文字列長さの制約: 最小長は 0 です。最大長は 200 です。必須: いいえ ** [tags](#API_PutBotAlias_RequestSyntax) ** ボットエイリアスに追加するタグのリスト。タグを追加できるのは、エイリアスを作成したときだけで、`PutBotAlias` オペレーションを使ってボットのエイリアスのタグを更新することはできません。タグを更新するには、`TagResource` のオペレーションを使用します。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "botName": "string", "botVersion": "string", "checksum": "string", "conversationLogs": { "iamRoleArn": "string", "logSettings": [ { "destination": "string", "kmsKeyArn": "string", "logType": "string", "resourceArn": "string", "resourcePrefix": "string" } ] }, "createdDate": number, "description": "string", "lastUpdatedDate": number, "name": "string", "tags": [ { "key": "string", "value": "string" } ] } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [botName](#API_PutBotAlias_ResponseSyntax) ** エイリアスが指すボットの名前。タイプ: 文字列長さの制限: 最小長は 2 です。最大長は 50 です。パターン: `^([A-Za-z]_?)+$` ** [botVersion](#API_PutBotAlias_ResponseSyntax) ** エイリアスが指すボットのバージョン。タイプ: 文字列長さの制約: 最小長は 1 です。最大長 64 パターン: `\$LATEST|[0-9]+` ** [checksum](#API_PutBotAlias_ResponseSyntax) ** 現在のバージョンのエイリアスのチェックサム。タイプ: 文字列 ** [conversationLogs](#API_PutBotAlias_ResponseSyntax) ** Amazon Lex がエイリアスの会話ログをどのように使用するかを決定する設定。型: [ConversationLogsResponse](API_ConversationLogsResponse.md) オブジェクト ** [createdDate](#API_PutBotAlias_ResponseSyntax) ** ボットエイリアスが作成された日付。型: タイムスタンプ ** [description](#API_PutBotAlias_ResponseSyntax) ** エイリアスの説明。型: 文字列長さの制約: 最小長は 0 です。最大長は 200 です。 ** [lastUpdatedDate](#API_PutBotAlias_ResponseSyntax) ** ボットエイリアスが更新された日付。リソースを作成する場合、作成日と最終更新日は同じ日付になります。型: タイムスタンプ ** [name](#API_PutBotAlias_ResponseSyntax) ** エイリアスの名前。型: 文字列長さの制約: 最小長は 1 です。最大長は 100 です。パターン: `^([A-Za-z]_?)+$` ** [tags](#API_PutBotAlias_ResponseSyntax) ** ボットに関連付けられているタグのリスト。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。 ## エラー ** BadRequestException ** リクエストが適切にフォーマットされていません。例えば、値が無効であったり、必須項目が設定されていない場合です。フィールドの値を確認して、再度お試しください。 HTTP ステータスコード: 400 ** ConflictException ** リクエストの処理中に競合が発生しました。リクエストを再試行してください。 HTTP ステータスコード: 409 ** InternalFailureException ** Amazon Lex 内部エラーが発生しました。リクエストを再試行してください。 HTTP ステータスコード: 500 ** LimitExceededException ** リクエストが制限を超えました。リクエストを再試行してください。 HTTP ステータスコード: 429 ** PreconditionFailedException ** 変更しようとしているリソースのチェックサムがリクエストのチェックサムと一致しません。リソースのチェックサムを確認して、もう一度お試しください。 HTTP ステータスコード: 412 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutBotAlias) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutBotAlias) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutBotAlias) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutBotAlias) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutBotAlias) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutBotAlias) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutBotAlias) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutBotAlias) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutBotAlias) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutBotAlias)