StartImport - Amazon Lex V1

支援終止通知:在 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

必要:是

tags

要新增至匯入機器人的標籤清單。您只能在匯入機器人時新增標籤,您無法將標籤新增至意圖或槽類型。

類型: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

tags

新增至匯入機器人的標籤清單。

類型:Tag 物件陣列

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

錯誤

BadRequestException

請求格式不正確。例如,值無效或缺少必要欄位。請檢查欄位值,然後再試一次。

HTTP 狀態碼:400

InternalFailureException

發生內部 Amazon Lex 錯誤。請再次嘗試您的請求。

HTTP 狀態碼:500

LimitExceededException

請求超過限制。請再次嘗試您的請求。

HTTP 狀態碼:429

另請參閱

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱以下內容: