支援終止通知:在 2025 年 9 月 15 日, AWS 將停止對 Amazon Lex V1 的支援。2025 年 9 月 15 日之後,您將無法再存取 Amazon Lex V1 主控台或 Amazon Lex V1 資源。如果您使用的是 Amazon Lex V2,請改參閱 Amazon Lex V2 指南。
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
取得 Amazon Lex V1 和 Amazon Lex V2 之間的遷移清單。
請求語法
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
-
從 Amazon Lex V1 遷移到 Amazon Lex V2 的摘要陣列。若要查看遷移的詳細資訊,請在 操作呼叫中使用
migrationId
摘要中的 GetMigration。類型:MigrationSummary 物件陣列
- nextToken
-
如果回應被截斷,則包含分頁字符,您可以在下一個請求中指定,以擷取下一頁的遷移。
類型:字串
錯誤
- BadRequestException
-
請求格式不正確。例如,值無效或缺少必要欄位。請檢查欄位值,然後再試一次。
HTTP 狀態碼:400
- InternalFailureException
-
發生內部 Amazon Lex 錯誤。請再次嘗試您的請求。
HTTP 狀態碼:500
- LimitExceededException
-
請求超過限制。請再次嘗試您的請求。
HTTP 狀態碼:429
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱下列內容: