GetMigrations - Amazon Lex V1

如果您使用的是 Amazon Lex V2,請改參閱 Amazon Lex V2 指南

 

如果您使用的是 Amazon Lex V1,我們建議您將機器人升級至 Amazon Lex V2。我們不再將新功能新增至 V1,並強烈建議對所有新機器人使用 V2。

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

GetMigrations

取得亞馬遜 Lex V1 和亞馬遜萊克斯 V2 之間的遷移清 Amazon Lex。

請求語法

GET /migrations?maxResults=maxResults&migrationStatusEquals=migrationStatusEquals&nextToken=nextToken&sortByAttribute=sortByAttribute&sortByOrder=sortByOrder&v1BotNameContains=v1BotNameContains HTTP/1.1

URI 請求參數

請求會使用下列 URI 參數。

maxResults

遷移的最大數量在響應中返回。預設為 10。

有效範圍:最小值為 1。最大值為 50。

migrationStatusEquals

篩選清單以僅包含指定狀態下的移轉。

有效值:IN_PROGRESS | COMPLETED | FAILED

nextToken

一個分頁令牌,用於獲取遷移的下一頁。如果截斷對此作業的回應,Amazon Lex 會在回應中傳回分頁權杖。要獲取遷移的下一頁,請在請求中指定分頁令牌。

sortByAttribute

要排序移轉清單所依據的欄位。您可以依 Amazon Lex V1 機器人名稱或開始遷移的日期和時間來排序。

有效值:V1_BOT_NAME | MIGRATION_DATE_TIME

sortByOrder

順序排序列表。

有效值:ASCENDING | DESCENDING

v1BotNameContains

篩選清單,使其只包含名稱包含指定字串的機器人。該字符串匹配機器人名稱中的任何位置。

長度約束:最小長度為 2。長度上限為 50。

模式:^([A-Za-z]_?)+$

請求主體

請求沒有請求主體。

回應語法

HTTP/1.1 200 Content-type: application/json { "migrationSummaries": [ { "migrationId": "string", "migrationStatus": "string", "migrationStrategy": "string", "migrationTimestamp": number, "v1BotLocale": "string", "v1BotName": "string", "v1BotVersion": "string", "v2BotId": "string", "v2BotRole": "string" } ], "nextToken": "string" }

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

migrationSummaries

從亞馬遜 Lex V1 遷移到亞馬遜萊克斯 V2 的摘要陣列。若要查看遷移的詳細資料,請在呼叫GetMigration作業時使用摘要。migrationId

類型:MigrationSummary 物件陣列

nextToken

如果響應被截斷,它包括一個分頁令牌,您可以在下一個請求中指定以獲取遷移的下一頁。

類型:字串

錯誤

BadRequestException

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

HTTP 狀態碼:400

InternalFailureException

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

HTTP 狀態碼:500

LimitExceededException

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

HTTP 狀態碼:429

另請參閱

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