CreateSlotTypeVersion - Amazon Lex V1
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

如果您使用的是 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 的詳細資訊，請參閱下列內容：