GetMigration - Amazon Lex V1

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

 

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

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

GetMigration

提供有關從 Amazon Lex V1 機器人進行中或完整遷移至 Amazon Lex V2 機器人的詳細資訊。使用此作業可檢視與移轉相關的移轉警示和警告。

請求語法

GET /migrations/migrationId HTTP/1.1

URI 請求參數

請求會使用下列 URI 參數。

migrationId

要檢視之移轉的唯一識別碼。由StartMigration作業傳回。migrationID

長度約束:固定長度為 10。

模式:^[0-9a-zA-Z]+$

必要:是

請求主體

請求沒有請求主體。

回應語法

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

回應元素

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

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

alerts

指出將 Amazon Lex V1 機器人移轉至 Amazon Lex V2 時發生問題的警示和警告清單。當 Amazon Lex V1 功能在 Amazon Lex V2 中具有不同的實作時,您會收到警告。

如需詳細資訊,請參閱 Amazon Lex V2 開發人員指南中的遷移機器人。

類型:MigrationAlert 物件陣列

migrationId

遷移的唯一識別碼。這與調用GetMigration操作時使用的標識符相同。

類型:字串

長度約束:固定長度為 10。

模式:^[0-9a-zA-Z]+$

migrationStatus

指出移轉的狀態。當狀態為COMPLETE移轉完成且機器人可在 Amazon Lex V2 中使用時。可能有警示和警告需要解決才能完成移轉。

類型:字串

有效值:IN_PROGRESS | COMPLETED | FAILED

migrationStrategy

用於執行移轉的策略。

  • CREATE_NEW-建立新的 Amazon Lex V2 機器人,並將 Amazon Lex V1 機器人移轉至新的機器人。

  • UPDATE_EXISTING-覆寫現有的 Amazon Lex V2 機器人中繼資料和要遷移的地區設定。它不會變更 Amazon Lex V2 機器人中的任何其他語言環境。如果語言環境不存在,則會在 Amazon Lex V2 機器人中建立新的地區設定。

類型:字串

有效值:CREATE_NEW | UPDATE_EXISTING

migrationTimestamp

移轉開始的日期和時間。

類型:Timestamp

v1BotLocale

Amazon Lex V1 機器人的地區設定已遷移到 Amazon Lex V2。

類型:字串

有效值:de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR

v1BotName

Amazon Lex V1 機器人的名稱遷移到 Amazon Lex V2。

類型:字串

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

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

v1BotVersion

Amazon Lex V1 機器人的版本遷移到 Amazon Lex V2。

類型:字串

長度限制:長度下限為 1。長度上限為 64。

模式:\$LATEST|[0-9]+

v2BotId

Amazon Lex V1 正在遷移到的亞 Amazon Lex V2 機器人的唯一識別碼。

類型:字串

長度約束:固定長度為 10。

模式:^[0-9a-zA-Z]+$

v2BotRole

亞馬遜萊克斯用來執行亞馬遜萊克 Amazon Lex V2 機器人的 IAM 角色。

類型:字串

長度限制︰長度下限為 20。長度上限為 2048。

模式:^arn:[\w\-]+:iam::[\d]{12}:role/.+$

錯誤

BadRequestException

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

HTTP 狀態碼:400

InternalFailureException

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

HTTP 狀態碼:500

LimitExceededException

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

HTTP 狀態碼:429

NotFoundException

找不到要求中指定的資源。請檢查資源,然後再試一次。

HTTP 狀態碼:404

另請參閱

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