PutBotAlias

フォーカスモード

PutBotAlias - Amazon Lex V1

リクエストの構文 URI リクエストパラメータリクエストボディレスポンスの構文レスポンス要素エラー以下の資料も参照してください。

サポート終了通知: 2025 年 9 月 15 日、 AWS は Amazon Lex V1 のサポートを終了します。 V1 2025 年 9 月 15 日以降、Amazon Lex V1 コンソールまたは Amazon Lex V1 リソースにアクセスできなくなります。Amazon Lex V2 を使用している場合は、代わりに Amazon Lex V2 ガイドを参照してください。

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

指定されたバージョンのボットのエイリアスを作成したり、指定されたボットのエイリアスを置き換えたりします。エイリアスが示すボットのバージョンを変更するには、エイリアスを置き換えます。エイリアスの詳細については、「バージョニングとエイリアス」を参照してください。

このオペレーションには、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

ボットの名前。

長さの制限: 最小長は 2 です。最大長は 50 です。

Pattern: ^([A-Za-z]_?)+$

必須: はい

name

エイリアスの名前。キースペース名では、大文字と小文字は区別されません。

長さの制限：最小長 1、最大長は 100 です。

Pattern: ^([A-Za-z]_?)+$

必須: はい

リクエストボディ

リクエストは以下の JSON 形式のデータを受け入れます。

botVersion

ボットのバージョン。

タイプ: 文字列

長さの制約: 最小長は 1 です。最大長 64

Pattern: \$LATEST|[0-9]+

必須: はい

checksum

$LATEST バージョンの特定のリビジョンを識別します。

新しいボットエイリアスを作成する場合は、checksum フィールドを空白にします。チェックサムを指定した場合、BadRequestException の例外が発生します。

ボットエイリアスを更新する場合は、checksum フィールドに $LATEST バージョンの最新リビジョンのチェックサムを設定します。checksum フィールドを指定しない場合や、チェックサムが $LATEST バージョンと一致しない場合は、PreconditionFailedException 例外が発生します。

タイプ: 文字列

必須: いいえ

conversationLogs

エイリアスの会話ログの設定。

型: ConversationLogsRequest オブジェクト

必須: いいえ

description

エイリアスの説明。

型: 文字列

長さの制約: 最小長は 0 です。最大長は 200 です。

必須: いいえ

tags

ボットエイリアスに追加するタグのリスト。タグを追加できるのは、エイリアスを作成したときだけで、PutBotAlias オペレーションを使ってボットのエイリアスのタグを更新することはできません。タグを更新するには、TagResource のオペレーションを使用します。

型: Tag オブジェクトの配列

配列メンバー: 最小数は 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"
      }
   ]
}