支援終止通知:在 2025 年 9 月 15 日, AWS 將停止對 Amazon Lex V1 的支援。2025 年 9 月 15 日之後,您將無法再存取 Amazon Lex V1 主控台或 Amazon Lex V1 資源。如果您使用的是 Amazon Lex V2,請改參閱 Amazon Lex V2 指南。
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
StartImport
啟動將資源匯入至 Amazon Lex 的任務。
請求語法
POST /imports/ HTTP/1.1
Content-type: application/json
{
"mergeStrategy": "string
",
"payload": blob
,
"resourceType": "string
",
"tags": [
{
"key": "string
",
"value": "string
"
}
]
}
URI 請求參數
請求不會使用任何 URI 參數。
請求主體
請求接受採用 JSON 格式的下列資料。
- mergeStrategy
-
指定當現有資源具有相同名稱時,
StartImport
操作應採取的動作。-
FAIL_ON_CONFLICT - 在匯入檔案中的資源與現有資源之間的第一次衝突時,會停止匯入操作。造成衝突的資源名稱位於
GetImport
操作回應的failureReason
欄位中。OVERWRITE_LATEST - 即使與現有資源發生衝突,匯入操作仍會繼續。現有資源的 $LASTEST 版本會以匯入檔案的資料覆寫。
類型:字串
有效值:
OVERWRITE_LATEST | FAIL_ON_CONFLICT
必要:是
-
- payload
-
二進位格式的 zip 封存。封存應包含一個檔案,其中包含要匯入之資源的 JSON 檔案。資源應符合
resourceType
欄位中指定的類型。類型:Base64 編碼的二進位資料物件
必要:是
- resourceType
-
指定要匯出的資源類型。每個資源也會匯出其依賴的任何資源。
-
機器人匯出相依意圖。
-
意圖匯出相依槽類型。
類型:字串
有效值:
BOT | INTENT | SLOT_TYPE
必要:是
-
-
要新增至匯入機器人的標籤清單。您只能在匯入機器人時新增標籤,您無法將標籤新增至意圖或槽類型。
類型:Tag 物件陣列
陣列成員:項目數下限為 0。項目數上限為 200。
必要:否
回應語法
HTTP/1.1 201
Content-type: application/json
{
"createdDate": number,
"importId": "string",
"importStatus": "string",
"mergeStrategy": "string",
"name": "string",
"resourceType": "string",
"tags": [
{
"key": "string",
"value": "string"
}
]
}
回應元素
如果動作成功,則服務傳回 HTTP 201 回應。
服務會傳回下列 JSON 格式的資料。
- createdDate
-
請求匯入任務的日期和時間的時間戳記。
類型:Timestamp
- importId
-
特定匯入任務的識別符。
類型:字串
- importStatus
-
匯入任務的狀態。如果狀態為
FAILED
,您可以使用GetImport
操作取得失敗的原因。類型:字串
有效值:
IN_PROGRESS | COMPLETE | FAILED
- mergeStrategy
-
發生合併衝突時要採取的動作。
類型:字串
有效值:
OVERWRITE_LATEST | FAIL_ON_CONFLICT
- name
-
提供給匯入任務的名稱。
類型:字串
長度限制:長度下限為 1。長度上限為 100。
模式:
[a-zA-Z_]+
- resourceType
-
要匯入的資源類型。
類型:字串
有效值:
BOT | INTENT | SLOT_TYPE
-
新增至匯入機器人的標籤清單。
類型:Tag 物件陣列
陣列成員:項目數下限為 0。項目數上限為 200。
錯誤
- BadRequestException
-
請求格式不正確。例如,值無效或缺少必要欄位。請檢查欄位值,然後再試一次。
HTTP 狀態碼:400
- InternalFailureException
-
發生內部 Amazon Lex 錯誤。請再次嘗試您的請求。
HTTP 狀態碼:500
- LimitExceededException
-
請求超過限制。請再次嘗試您的請求。
HTTP 狀態碼:429
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱以下內容: