PutBotAlias

焦點模式

PutBotAlias - Amazon Lex V1

支援終止通知：在 2025 年 9 月 15 日， AWS 將停止對 Amazon Lex 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。

模式：^([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"
      }
   ]
}