支援終止通知：2025 年 9 月 15 日， AWS 將停止對 Amazon Lex V1 的支援。2025 年 9 月 15 日之後，您將無法再存取 Amazon Lex V1 主控台或 Amazon Lex V1 資源。如果您使用的是 Amazon Lex V2，請改參閱 [Amazon Lex V2 指南](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html)。

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

# GetMigration
<a name="API_GetMigration"></a>

提供持續或完整從 Amazon Lex V1 機器人遷移至 Amazon Lex V2 機器人的詳細資訊。使用此操作來檢視與遷移相關的遷移提醒和警告。

## 請求語法
<a name="API_GetMigration_RequestSyntax"></a>

```
GET /migrations/migrationId HTTP/1.1
```

## URI 請求參數
<a name="API_GetMigration_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [migrationId](#API_GetMigration_RequestSyntax) **   <a name="lex-GetMigration-request-uri-migrationId"></a>
要檢視之遷移的唯一識別符。[StartMigration](API_StartMigration.md) 操作`migrationID`會傳回 。  
長度限制：固定長度為 10。  
模式：`^[0-9a-zA-Z]+$`  
必要：是

## 請求主體
<a name="API_GetMigration_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_GetMigration_ResponseSyntax"></a>

```
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"
}
```

## 回應元素
<a name="API_GetMigration_ResponseElements"></a>

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

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

 ** [alerts](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-alerts"></a>
提醒和警告清單，指出 Amazon Lex V1 機器人遷移至 Amazon Lex V2 時發生問題。當 Amazon Lex V1 功能在 Amazon Lex V2 中具有不同的實作時，您會收到警告。  
如需詳細資訊，請參閱《*Amazon Lex V2 開發人員指南*》中的[遷移機器人](https://docs.aws.amazon.com/lexv2/latest/dg/migrate.html)。  
類型：[MigrationAlert](API_MigrationAlert.md) 物件陣列

 ** [migrationId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationId"></a>
遷移的唯一識別符。這與呼叫 `GetMigration`操作時所使用的識別符相同。  
類型：字串  
長度限制：固定長度為 10。  
模式：`^[0-9a-zA-Z]+$`

 ** [migrationStatus](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStatus"></a>
指出遷移的狀態。當狀態為遷移完成`COMPLETE`且機器人可在 Amazon Lex V2 中使用時。可能需要解決提醒和警告，才能完成遷移。  
類型：字串  
有效值:`IN_PROGRESS | COMPLETED | FAILED` 

 ** [migrationStrategy](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStrategy"></a>
用來執行遷移的策略。  
+  `CREATE_NEW` - 建立新的 Amazon Lex V2 機器人，並將 Amazon Lex V1 機器人遷移至新的機器人。
+  `UPDATE_EXISTING` - 覆寫現有的 Amazon Lex V2 機器人中繼資料和要遷移的地區設定。它不會變更 Amazon Lex V2 機器人中的任何其他地區設定。如果地區設定不存在，則會在 Amazon Lex V2 機器人中建立新的地區設定。
類型：字串  
有效值:`CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationTimestamp"></a>
遷移開始的日期和時間。  
類型：Timestamp

 ** [v1BotLocale](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotLocale"></a>
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](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotName"></a>
遷移至 Amazon Lex V2 的 Amazon Lex V1 機器人名稱。 Amazon Lex V2  
類型：字串  
長度限制：長度下限為 2。長度上限為 50。  
模式：`^([A-Za-z]_?)+$`

 ** [v1BotVersion](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotVersion"></a>
Amazon Lex V1 機器人的版本已遷移至 Amazon Lex V2。  
類型：字串  
長度限制：長度下限為 1。長度上限為 64。  
模式：`\$LATEST|[0-9]+`

 ** [v2BotId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotId"></a>
要遷移至 Amazon Lex V1 之 Amazon Lex V2 機器人的唯一識別符。 Amazon Lex V1   
類型：字串  
長度限制：固定長度為 10。  
模式：`^[0-9a-zA-Z]+$`

 ** [v2BotRole](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotRole"></a>
Amazon Lex 用來執行 Amazon Lex V2 機器人的 IAM 角色。  
類型：字串  
長度限制︰長度下限為 20。長度上限為 2048。  
模式：`^arn:[\w\-]+:iam::[\d]{12}:role/.+$`

## 錯誤
<a name="API_GetMigration_Errors"></a>

 ** BadRequestException **   
請求格式不正確。例如，值無效或缺少必要欄位。請檢查欄位值，然後再試一次。  
HTTP 狀態碼：400

 ** InternalFailureException **   
發生內部 Amazon Lex 錯誤。請再次嘗試您的請求。  
HTTP 狀態碼：500

 ** LimitExceededException **   
請求超過限制。請再次嘗試您的請求。  
HTTP 狀態碼：429

 ** NotFoundException **   
找不到請求中指定的資源。請檢查資源，然後再試一次。  
HTTP 狀態碼：404

## 另請參閱
<a name="API_GetMigration_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetMigration) 
+  [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetMigration) 
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetMigration) 
+  [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetMigration) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetMigration) 
+  [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetMigration) 
+  [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetMigration) 
+  [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetMigration) 
+  [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetMigration) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetMigration)