如果您使用的是 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 的詳細資訊,請參閱下列內容: