支援終止通知:2025 年 9 月 15 日, AWS 將停止對 Amazon Lex V1 的支援。2025 年 9 月 15 日之後,您將無法再存取 Amazon Lex V1 主控台或 Amazon Lex V1 資源。如果您使用的是 Amazon Lex V2,請改參閱 Amazon Lex 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。10000 個項目的數量上限。
- 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 SDKs中使用此 API 的詳細資訊,請參閱下列內容: