PutBotAlias

為指定的機器人版本建立別名，或取代指定機器人的別名。若要變更別名指向的機器人版本，請取代別名。如需關於別名的詳細資訊，請參閱版本控制與別名。

這項操作需要 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。

模式：^([A-Za-z]_?)+$

必要：是

name

別名的名稱。名稱不區分大小寫。

長度限制：長度下限為 1。長度上限為 100。

模式：^([A-Za-z]_?)+$

必要：是

請求主體

請求接受採用 JSON 格式的下列資料。

botVersion

機器人的版本。

類型：字串

長度限制：長度下限為 1。長度上限為 64。

模式：\$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"
      }
   ]
}