AWS Application Discovery Service 不再向新客戶開放。或者，使用 AWS Transform 提供類似的功能。如需詳細資訊，請參閱 [AWS Application Discovery Service 可用性變更](https://docs.aws.amazon.com/application-discovery/latest/userguide/application-discovery-service-availability-change.html)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 將資料匯入至 Migration Hub
AWS Migration Hub (Migration Hub) 匯入可讓您直接將內部部署環境的詳細資訊匯入 Migration Hub，而無需使用 Application Discovery Service Agentless Collector (Agentless Collector) 或 AWS Application Discovery Agent (Discovery Agent)，因此您可以直接從匯入的資料執行遷移評估和規劃。您也可以將裝置群組為應用程式並追蹤其遷移狀態。
此頁面說明完成匯入請求的步驟。首先，您可以使用下列兩個選項之一來準備您的現場部署伺服器資料。
+ 使用常見的第三方工具來產生包含現場部署伺服器資料的檔案。
+ 下載逗號分隔值 (CSV) 匯入範本，並填入您的內部部署伺服器資料。
使用上述兩種方法來建立內部部署資料檔案之後，您可以使用 Migration Hub 主控台 AWS CLI或其中一個 AWS SDKs，將檔案上傳至 Migration Hub。如需兩個選項的詳細資訊，請參閱 [支援的匯入格式](#import-supported-formats)。
您可以提交多個匯入請求。每個請求都會循序處理。您可以透過主控台或匯入 API 隨時檢查匯入請求的狀態。
匯入請求完成後，您可以檢視個別匯入記錄的詳細資訊。直接從 Migration Hub 主控台檢視使用率資料、標籤和應用程式映射。如果匯入時遇到錯誤，您可以檢閱成功與失敗記錄的計數，以及查看各個失敗記錄的錯誤詳細資訊。
**處理錯誤：**已提供連結來下載錯誤日誌和失敗的記錄檔案，此檔案為 CSV 檔案的壓縮存檔。在修正錯誤之後，使用這些檔案重新提交匯入請求。
數量限制適用於匯入的記錄、匯入的伺服器和可保留的刪除記錄。如需詳細資訊，請參閱[AWS Application Discovery Service 配額](ads_service_limits.md)。
## 支援的匯入格式
**Topics**
+ [RVTools](#import-rvtools)
+ [Migration Hub 匯入範本](#import-template-fields)
### RVTools
Migration Hub 支援透過 RVTools 匯入 VMware vSphere 的匯出。從 RVTools 儲存資料時，請先選擇**全部匯出至 csv** 選項或**全部匯出至 Excel** 選項，然後 ZIP 資料夾，然後將 ZIP 檔案匯入 Migration Hub。ZIP 中需要下列檔案：vInfo、vNetwork、vCpu、vMemory、vDisk、vPartition、vSource、vTools、vHost、vNic、vSC\_VMK。
### Migration Hub 匯入範本
Migration Hub 匯入可讓您從任何來源匯入資料。提供的資料必須是 CSV 檔案支援的格式，而且資料必須只包含支援的欄位以及這些欄位支援的範圍。
下表中匯入欄位名稱旁的星號 (\*) 表示它是必要欄位。您的匯入檔案的每個記錄皆至少必須填入一或多個這些必要欄位，以唯一識別伺服器或應用程式。否則，沒有任何必要欄位的記錄將無法匯入。
下表中匯入存檔名稱旁的插入符號 (^) 表示如果提供 serverId，則為唯讀。
**注意**
如果您是使用 VMware.MoRefId 或 VMWare.VCenterId 來識別記錄，您必須在相同的記錄中有這兩個欄位。
| 匯入欄位名稱 | Description | 範例 |
| --- | --- | --- |
| ExternalId\*^ | 自訂的識別符，可讓您將每個記錄標示為唯一。例如，ExternalId (ExternalId) 可以是您資料中心伺服器的庫存 ID。 | Inventory Id 1
Server 2
CMBD Id 3 |
| SMBiosId^ | 系統管理 BIOS (SMBIOS) ID。 | |
| IPAddress\*^ | 以逗號分隔的伺服器 IP 地址清單，以引號括住。 | 192.0.0.2
"10.12.31.233, 10.12.32.11" |
| MACAddress\*^ | 以逗號分隔的伺服器 MAC 地址清單，以引號括住。 | 00:1B:44:11:3A:B7
"00-15-E9-2B-99-3C, 00-14-22-01-23-45" |
| HostName\*^ | 伺服器的主機名稱。我們建議此值應使用完整網域名稱 (FQDN)。 | ip-1-2-3-4
localhost.domain |
| VMware.MoRefId\*^ | 受管物件參考 ID。必須以 VMware.VCenterId 提供。 | |
| VMware.VCenterId\*^ | 虛擬機器唯一識別符。必須以 VMware.MoRefId 提供。 | |
| CPU.NumberOfProcessors^ | CPU 的數量。 | 4 |
| CPU.NumberOfCores^ | 實體核心總數。 | 8 |
| CPU.NumberOfLogicalCores^ | 可在伺服器中所有 CPUs 同時執行的執行緒總數。部分 CPU 可在單一 CPU 核心上同時執行多個執行緒。在這些情況下，此值會大於實體 (或虛擬) 核心的數量。 | 16 |
| OS.Name^ | 作業系統的名稱。 | Linux
Windows.Hat |
| OS.Version^ | 作業系統的版本。 | 16.04.3
NT 6.2.8 |
| VMware.VMName^ | 虛擬機器的名稱。 | Corp1 |
| RAM.TotalSizeInMB^ | 伺服器上可用的 RAM 總量，以 MB 為單位。 | 64
128 |
| RAM.UsedSizeInMB.Avg^ | 伺服器上已用記憶體的平均數量，以 MB 為單位。 | 64
128 |
| RAM.UsedSizeInMB.Max^ | 伺服器上可用的已用 RAM 數量上限，以 MB 為單位。 | 64
128 |
| CPU.UsagePct.Avg^ | 當探索工具收集資料時的平均 CPU 使用率。 | 45
23.9 |
| CPU.UsagePct.Max^ | 當探索工具收集資料時的最大 CPU 使用率。 | 55.34
24 |
| DiskReadsPerSecondInKB.Avg^ | 磁碟平均每秒讀取的數目，以 KB 為單位。 | 1159
84506 |
| DiskWritesPerSecondInKB.Avg^ | 磁碟平均每秒寫入的數目，以 KB 為單位。 | 199
6197 |
| DiskReadsPerSecondInKB.Max^ | 磁碟最大每秒讀取的數目，以 KB 為單位。 | 37892
869962 |
| DiskWritesPerSecondInKB.Max^ | 磁碟最大每秒寫入的數目，以 KB 為單位。 | 18436
1808 |
| DiskReadsOpsPerSecond.Avg^ | 每秒磁碟讀取操作的平均數目。 | 45
28 |
| DiskWritesOpsPerSecond.Avg^ | 磁碟寫入 操作的每秒平均次數。 | 8
3 |
| DiskReadsOpsPerSecond.Max^ | 磁碟每秒讀取操作的最大數目。 | 1083
176 |
| DiskWritesOpsPerSecond.Max^ | 磁碟寫入操作的每秒最大次數。 | 535
71 |
| NetworkReadsPerSecondInKB.Avg^ | 網路讀取操作的每秒平均數量，以 KB 為單位。 | 45
28 |
| NetworkWritesPerSecondInKB.Avg^ | 網路寫入操作的每秒平均數量，以 KB 為單位。 | 8
3 |
| NetworkReadsPerSecondInKB.Max^ | 網路讀取操作的每秒最大數量，以 KB 為單位。 | 1083
176 |
| NetworkWritesPerSecondInKB.Max^ | 網路寫入操作的每秒最大數量，以 KB 為單位。 | 535
71 |
| 應用程式 | 以逗號分隔之包含此伺服器的應用程式清單，以引號括住。此值可包含現有應用程式和/或匯入時建立的新應用程式。 | Application1
"Application2, Application3" |
| ApplicationWave | 此伺服器的遷移波動。 | |
| 標籤^ | 以逗號分隔的標籤清單，格式為「名稱:值」。 請不要將敏感資訊 (例如個人資料) 儲存在標籤中。 | "zone:1, critical:yes"
"zone:3, critical:no, zone:1" |
| ServerId | 如 Migration Hub 伺服器清單中所示的伺服器識別符。 | d-server-01kk9i6ywwaxmp |
您可以匯入資料，即使您沒有將資料填入匯入範本中定義的所有欄位，只要每個記錄中至少有一個必要的欄位即可。透過使用外部或內部相符金鑰，以管理多個匯入請求中的重複項目。如果您填入自己的相符金鑰 `External ID`，此欄位將用於唯一識別和匯入記錄。若未指定相符金鑰，匯入作業將使用內部產生的相符金鑰，它來自於匯入範本的一些資料欄。如需此比對的詳細資訊，請參閱[針對探索到的伺服器和應用程式比對邏輯](view-data.md#add-match-logic)。
**注意**
Migration Hub 匯入不支援匯入範本中定義欄位以外的任何欄位。任何自訂的欄位都將被忽略，因此不會匯入。
## 設定匯入許可
在您可以匯入資料之前，請確定您的 IAM 使用者具有必要的 Amazon S3 許可，可將您的匯入檔案上傳 (`s3:PutObject`) 至 Amazon S3，以及讀取物件 (`s3:GetObject`)。您也必須透過建立 IAM 政策並將其連接至在您 AWS 帳戶中執行匯入的 IAM 使用者，來建立程式設計存取 （適用於 AWS CLI) 或主控台存取。
------
#### [ Console Permissions ]
使用下列程序來編輯 IAM 使用者的許可政策，該使用者將使用 主控台在您的 AWS 帳戶中提出匯入請求。
**編輯使用者連接的受管政策**
1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam) 開啟 IAM 主控台。
1. 在導覽窗格中，選擇 **Users** (使用者)。
1. 選擇您想要為其變更許可政策的使用者名稱。
1. 選擇 **Permissions (許可)** 索引標籤，然後選擇 **Add permissions (新增許可)**。
1. 選擇 **Attach existing policies directly (直接連接現有政策)**，然後選擇 **Create policy (建立政策)**。
1. 在開啟的 **Create policy (建立政策)** 頁面上，選擇 **JSON (JSON)** 並貼上以下政策。請記得將您儲存貯體的名稱，更換為 IAM 使用者將上傳檔案之儲存貯體的實際名稱。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:GetBucketLocation",
"s3:ListAllMyBuckets"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": ["s3:ListBucket"],
"Resource": ["arn:aws:s3:::{{importBucket}}"]
},
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject"
],
"Resource": ["arn:aws:s3:::{{importBucket}}/*"]
}
]
}
```
------
1. 選擇**檢閱政策**。
1. 為您的政策指定新的 **Name (名稱)** 和選用描述，然後檢閱政策的摘要。
1. 選擇**建立政策**。
1. 返回授予**許可** IAM 主控台頁面，供將在您 AWS 帳戶中提出匯入請求的使用者使用。
1. 重新整理政策表，並搜尋您剛建立的政策名稱。
1. 選擇下**一步：檢閱**。
1. 選擇**新增許可**。
現在您已將政策新增至 IAM 使用者，即可開始匯入程序。
------
#### [ AWS CLI Permissions ]
使用下列程序建立必要的受管政策，以授予 IAM 使用者使用 提出匯入資料請求的許可 AWS CLI。
**建立和連接 受管政策**
1. 使用 `aws iam create-policy` AWS CLI 命令建立具有下列許可的 IAM 政策。請記得將您儲存貯體的名稱，更換為 IAM 使用者將上傳檔案之儲存貯體的實際名稱。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:ListBucket"],
"Resource": ["arn:aws:s3:::{{importBucket}}"]
},
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject"
],
"Resource": ["arn:aws:s3:::{{importBucket}}/*"]
}
]
}
```
------
如需使用此命令的詳細資訊，請參閱《 *AWS CLI 命令參考*》中的 [create-policy](https://docs.aws.amazon.com/cli/latest/reference/iam/create-policy.html)。
1. 使用 `aws iam create-policy` AWS CLI 命令建立具有下列許可的其他 IAM 政策。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"discovery:ListConfigurations",
"discovery:CreateApplication",
"discovery:UpdateApplication",
"discovery:AssociateConfigurationItemsToApplication",
"discovery:DisassociateConfigurationItemsFromApplication",
"discovery:GetDiscoverySummary",
"discovery:StartImportTask",
"discovery:DescribeImportTasks",
"discovery:BatchDeleteImportData"
],
"Resource": "*"
}
]
}
```
------
1. 使用 `aws iam attach-user-policy` AWS CLI 命令將您在前兩個步驟中建立的政策連接到將使用 在帳戶中 AWS 執行匯入請求的 IAM 使用者 AWS CLI。如需使用此命令的詳細資訊，請參閱《 *AWS CLI 命令參考*》中的 [attach-user-policy](https://docs.aws.amazon.com/cli/latest/reference/iam/attach-user-policy.html)。
現在您已將政策新增至 IAM 使用者，即可開始匯入程序。
------
請記住，當 IAM 使用者將物件上傳到您指定的 Amazon S3 儲存貯體時，他們必須保留物件的預設許可集，以便使用者可以讀取物件。
## 將匯入檔案上傳至 Amazon S3
接下來，您必須將 CSV 格式的匯入檔案上傳至 Amazon S3，才能匯入檔案。開始之前，您應該有一個 Amazon S3 儲存貯體，該儲存貯體會事先建立和/或選擇匯入檔案。
------
#### [ Console S3 Upload ]
**將匯入檔案上傳至 Amazon S3**
1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)：// 開啟 Amazon S3 主控台。
1. 在 **Bucket name (儲存貯體名稱)** 清單中，選擇您要上傳物件的目標儲存貯體名稱。
1. 選擇**上傳**。
1. 在 **Upload (上傳)** 對話方塊中，選擇 **Add files (新增檔案)** 來選擇要上傳的檔案。
1. 選擇要上傳的檔案，然後選擇 **Open (開啟)**。
1. 選擇**上傳**。
1. 上傳您的檔案之後，請從您的儲存貯體儀表板選擇資料檔案物件的名稱。
1. 從物件詳細資訊頁面的 **Overview (概觀)** 索引標籤，複製 **Object URL (物件 URL)**。您在建立匯入請求時，將需要用到此 URL。
1. 前往 Migration Hub 主控台中的**匯入**頁面，如中所述[匯入 資料](#start-data-import)。然後，將物件 URL 貼到 **Amazon S3 物件 URL** 欄位中。
------
#### [ AWS CLI S3 Upload ]
**將匯入檔案上傳至 Amazon S3**
1. 開啟終端機視窗，並導覽至儲存匯入檔案的目錄。
1. 輸入以下命令：
```
aws s3 cp {{ImportFile.csv}} s3://{{BucketName}}/{{ImportFile.csv}}
```
1. 這會傳回下列結果：
```
upload: .\{{ImportFile.csv}} to s3://{{BucketName}}/{{ImportFile.csv}}
```
1. 複製傳回的完整 Amazon S3 物件路徑。建立匯入請求時，您將需要此項目。
------
## 匯入 資料
從 Migration Hub 主控台下載匯入範本並填入現有的內部部署伺服器資料之後，您就可以開始將資料匯入 Migration Hub。下列指示說明兩種執行此作業的方式，包括使用 主控台或透過 進行 API 呼叫 AWS CLI。
------
#### [ Console Import ]
在 Migration Hub 主控台**的工具**頁面上開始資料匯入。
**開始匯入資料**
1. 在導覽窗格中的 **Discover (探索)** 下，選擇 **Tools (工具)**。
1. 如果您尚未填寫匯入範本，您可以在**匯入**方塊中選擇**匯入範本**來下載範本。開啟下載範本並填入您現有的現場部署伺服器資料。您也可以從 Amazon S3 儲存貯體下載匯入範本，網址為 https：//[https://s3.us-west-2.amazonaws.com/templates-7cffcf56-bd96-4b1c-b45b-a5b42f282e46/import\_template.csv](https://s3.us-west-2.amazonaws.com/templates-7cffcf56-bd96-4b1c-b45b-a5b42f282e46/import_template.csv)
1. 若要開啟**匯入**頁面，請在**匯入**方塊中選擇**匯入**。
1. 在**匯入名稱**下，指定匯入的名稱。
1. 填寫 **Amazon S3 物件 URL** 欄位。若要執行此步驟，您需要將匯入資料檔案上傳至 Amazon S3。如需詳細資訊，請參閱[將匯入檔案上傳至 Amazon S3](#migration-hub-import-s3-upload)。
1. 選擇右下區域中的 **Import (匯入)**。這將開啟 **Imports (匯入)** 頁面，您可在此查看以表格列出的您的匯入和其狀態。
按照前述程序開始匯入資料之後，**Imports (匯入)** 頁面會顯示每個匯入請求的詳細資訊，包括其進度狀態、完成時間，以及成功或失敗記錄的數量，並可下載這些記錄。在此畫面中，您也可以導覽至**探索**下的**伺服器**頁面，以查看實際匯入的資料。
在 **Servers (伺服器)** 頁面上，您可以查看所有已探索到的伺服器 (裝置) 及匯入名稱。當您選取名稱欄中列出的匯入**名稱**，從**匯入** （匯入歷史記錄） 頁面導覽時，系統會將您導向伺服器****頁面，其中會根據選取的匯入資料集套用篩選條件。然後，您只會看到屬於該特定匯入的資料。
詞存檔為 .zip 格式，並包含兩個檔案；`errors-file` 以及 `failed-entries-file`。此錯誤檔案包含與每個失敗行關聯的錯誤訊息，以及您匯入失敗的資料檔案的關聯欄位名稱。您可以使用此檔案快速識別哪裡發生問題。失敗的項目檔案包含失敗的每個行和所有提供的欄位。您可以在此檔案變更錯誤檔案中標示的部分，並再次嘗試匯入已修正資訊的檔案。
------
#### [ AWS CLI Import ]
若要從 開始資料匯入程序 AWS CLI， AWS CLI 必須先在您的環境中安裝 。如需詳細資訊，請參閱*AWS Command Line Interface 《 使用者指南*》中的[安裝 AWS 命令列界面](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html)。
**注意**
如果您尚未填寫匯入範本，您可以從我們的 Amazon S3 儲存貯體下載匯入範本：https：//[https://s3.us-west-2.amazonaws.com/templates-7cffcf56-bd96-4b1c-b45b-a5b42f282e46/import\_template.csv](https://s3.us-west-2.amazonaws.com/templates-7cffcf56-bd96-4b1c-b45b-a5b42f282e46/import_template.csv)
**開始匯入資料**
1. 請開啟終端機視窗並輸入下列命令：
```
aws discovery start-import-task --import-url s3://{{BucketName}}/{{ImportFile.csv}} --name {{ImportName}}
```
1. 這會建立匯入任務，並傳回以下狀態資訊：
```
{
"task": {
"status": "IMPORT_IN_PROGRESS",
"applicationImportSuccess": 0,
"serverImportFailure": 0,
"serverImportSuccess": 0,
"name": "{{ImportName}}",
"importRequestTime": 1547682819.801,
"applicationImportFailure": 0,
"clientRequestToken": "EXAMPLE1-abcd-1234-abcd-EXAMPLE1234",
"importUrl": "s3://{{BucketName}}/{{ImportFile.csv}}",
"importTaskId": "import-task-EXAMPLE1229949eabfEXAMPLE03862c0"
}
}
```
------
## 追蹤您的 Migration Hub 匯入請求
您可以使用 主控台 AWS CLI或其中一個 AWS SDKs 來追蹤 Migration Hub 匯入請求的狀態。
------
#### [ Console Tracking ]
從 Migration Hub 主控台的**匯入**儀表板，您可以找到下列元素。
+ **名稱** – 匯入請求的名稱。
+ **匯入 ID** – 匯入請求的唯一 ID。
+ **匯入時間** – 建立匯入請求的日期和時間。
+ **匯入狀態** – 匯入請求的狀態。這可以是下列其中一個值：
+ **匯入 –** 目前正在匯入此資料檔案。
+ **已匯入** – 已成功匯入整個資料檔案。
+ **匯入時發生錯誤** – 資料檔案中的一或多個記錄無法匯入。若要解決您的失敗記錄，請為您的匯入任務選擇 **Download failed records (下載失敗紀錄)**，解決失敗項目 csv 檔案中的錯誤之後再次執行匯入。
+ **匯入失敗** – 匯入的資料檔案中沒有記錄。若要解決您的失敗記錄，請為您的匯入任務選擇 **Download failed records (下載失敗紀錄)**，解決失敗項目 csv 檔案中的錯誤之後再次執行匯入。
+ **匯入的記錄** – 特定資料檔案中已成功匯入的記錄數目。
+ **失敗的記錄** – 未匯入的特定資料檔案中的記錄數目。
------
#### [ CLI Tracking ]
您可以使用 `aws discovery describe-import-tasks` AWS CLI 命令追蹤匯入任務的狀態。
1. 請開啟終端機視窗並輸入下列命令：
```
aws discovery describe-import-tasks
```
1. 這將以 JSON 格式傳回您所有匯入任務的清單，並包含狀態和其他相關資訊。或者，您可以篩選結果以傳回部分的匯入任務。
在追蹤您的匯入任務時，您可能會發現傳回的 `serverImportFailure` 值大於 0。發生此情況時，表示您的匯入檔案有一或多個項目無法匯入。您可以下載失敗記錄存檔，檢閱其中的檔案，然後以修改後的 failed-entries.csv 檔案再次執行匯入請求，即可解決此問題。
------
建立匯入任務後，您可以執行其他動作，以協助管理和追蹤您的資料遷移。例如，您可以下載特定請求的失敗記錄存檔。如需有關使用失敗記錄存檔解決匯入問題的詳細資訊，請參閱[對失敗的匯入記錄進行故障診斷](troubleshooting.md#troubleshooting-import-failed-records)。