如果您使用的是 Amazon Lex V2,請參閱 Amazon Lex V2 指南。
如果您使用的是 Amazon Lex V1,我們建議您將機器人升級到 Amazon Lex V2。我們不再向 V1 添加新功能,強烈建議所有新的機器人使用 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_CONFLACT-匯入檔案中的資源與現有資源之間的第一次衝突時,匯入作業會停止。造成衝突的資源名稱位於對
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 SDK 中使用此 API 的詳細資訊,請參閱下列內容: