CreateSlotTypeVersion - Amazon Lex V1

如果您使用的是 Amazon Lex V2,請參閱 Amazon Lex V2 指南

 

如果您使用的是 Amazon Lex V1,我們建議您將機器人升級到 Amazon Lex V2。我們不再向 V1 添加新功能,強烈建議所有新機器人使用 V2。

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

CreateSlotTypeVersion

根據指定插槽類型的$LATEST版本建立插槽類型的新版本。如果自上次建立$LATEST版本以來,此資源的版本並未變更,Amazon Lex 不會建立新版本。它返回您創建的最後一個版本。

注意

您只能更新插槽類型的$LATEST版本。您無法更新使用CreateSlotTypeVersion作業建立的編號版本。

當您建立插槽類型的版本時,Amazon Lex 會將版本設定為 1。後續版本會累加 1。如需詳細資訊,請參閱 版本控制

這項操作需要 lex:CreateSlotTypeVersion 動作的許可。

請求語法

POST /slottypes/name/versions HTTP/1.1 Content-type: application/json { "checksum": "string" }

URI 請求參數

請求會使用下列 URI 參數。

name

您要為其建立新版本之插槽類型的名稱。名稱區分大小寫。

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

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

必要:是

請求主體

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

checksum

您要發佈之插槽類型$LATEST版本的總和檢查碼。如果您指定總和檢查碼,且插槽類型的$LATEST版本具有不同的總和檢查碼,Amazon Lex 會傳回PreconditionFailedException例外狀況且不會發佈新版本。如果您未指定總和檢查碼,Amazon Lex 會發佈該$LATEST版本。

類型:字串

必要:否

回應語法

HTTP/1.1 201 Content-type: application/json { "checksum": "string", "createdDate": number, "description": "string", "enumerationValues": [ { "synonyms": [ "string" ], "value": "string" } ], "lastUpdatedDate": number, "name": "string", "parentSlotTypeSignature": "string", "slotTypeConfigurations": [ { "regexConfiguration": { "pattern": "string" } } ], "valueSelectionStrategy": "string", "version": "string" }

回應元素

如果動作成功,則服務傳回 HTTP 201 回應。

服務會傳回下列 JSON 格式的資料。

checksum

插槽類型$LATEST版本的總和檢查碼。

類型:字串

createdDate

插槽類型的建立日期。

類型:Timestamp

description

位置類型的描述。

類型:字串

長度限制:長度下限為 0。長度上限為 200。

enumerationValues

定義插槽類型可採用的值的EnumerationValue物件清單。

類型:EnumerationValue 物件陣列

陣列成員:項目數下限為 0。最多可包含 1 萬個項目。

lastUpdatedDate

更新插槽類型的日期。建立資源時,建立日期和上次更新日期相同。

類型:Timestamp

name

位置類型的名稱。

類型:字串

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

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

parentSlotTypeSignature

內建插槽類型使用插槽類型的父系。

類型:字串

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

模式:^((AMAZON\.)_?|[A-Za-z]_?)+

slotTypeConfigurations

擴充上層內建插槽類型的組態資訊。

類型:SlotTypeConfiguration 物件陣列

陣列成員:項目數下限為 0。項目數上限為 10。

valueSelectionStrategy

Amazon Lex 用來判斷插槽價值的策略。如需詳細資訊,請參閱 PutSlotType

類型:字串

有效值:ORIGINAL_VALUE | TOP_RESOLUTION

version

指派給新插槽類型版本的版本。

類型:字串

長度限制:長度下限為 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 SDK 中使用此 API 的詳細資訊,請參閱下列內容: