本頁面由 Cloud Translation API 翻譯而成。

手動建立及上傳資料表

您可以使用提供的範本，在 Migration Center 上傳手動填寫的資料表。如果基礎架構的資產數量有限，且您想手動建立資料，這個方法就非常實用。

如要手動建立及上傳資料表，請按照下列步驟操作：

從可用範本清單下載範本。
手動在資料表中填入基礎架構的資料。
將資料表上傳至 Migration Center。

限制

上傳的檔案大小上限為 100 MB。

可用的資料範本

下表提供檔案範本，可用於將基礎架構資料上傳至 Migration Center。範本中包含範例資料，可做為填寫表格的參考。如需必要資料格式的詳細說明，請參閱「匯入檔案規格」。

檔案名稱	資料類型	說明
vmInfo.csv	電腦資訊	使用這個範本提供個別資產的資訊，包括 CPU、記憶體和其他設定參數。每次建立新的匯入作業時，都必須提供這份表格。
perfInfo.csv	效能資料	選用：使用這個範本，以時間序列格式提供素材資源的成效資料。
diskInfo.csv	磁碟資料	選用：使用這個範本提供磁碟及其使用率的相關資訊。
tagInfo.csv	系統標記	選用：使用這個範本將鍵值屬性指派給 Amazon Web Services (AWS) 資產。屬性格式為 `"tag:KEY" : "VALUE"`。例如 `"tag:Name" : "AWS-example"`。

如要進一步瞭解各檔案的規格，請參閱「匯入檔案規格」。

上傳資料表

如要上傳檔案，請按照下列步驟操作：

主控台

前往「資料匯入」頁面。

前往「資料匯入」
依序點選「新增資料」>「上傳檔案」。
在「設定檔案上傳」部分，輸入檔案上傳的名稱。
從「檔案格式」清單中，選取「手動填入的 CSV 範本」。
按一下「選取要上傳的檔案」，然後選取要上傳的所有檔案。
按一下「上傳檔案」，確認並開始上傳檔案。
如果檔案通過驗證，請按一下「匯入資料」，然後按一下「確認」，即可從檔案建立素材資源。

API

建立匯入工作。
```
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs?importJobId=IMPORT_JOB_ID

{
  "asset_source": "projects/PROJECT_ID/locations/REGION/sources/SOURCE_ID"
}
```
更改下列內容：
- PROJECT_ID：用於建立匯入作業的專案 ID。
- REGION：建立匯入作業的區域。
- IMPORT_JOB_ID：新匯入作業的 ID。
- SOURCE_ID：要與匯入工作建立關聯的現有來源 ID。

選用：如要確認匯入工作是否已正確建立，請取得匯入工作。

GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

建立附加至匯入工作的匯入資料檔案。

POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles?import_data_file_id=DATA_FILE_ID

{
  "format": "IMPORT_JOB_FORMAT"
}

更改下列內容：

DATA_FILE_ID：新資料檔案的 ID
IMPORT_JOB_FORMAT： IMPORT_JOB_FORMAT_MANUAL_CSV

取得資料檔案。

GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID

從回應的 signedUrl 欄位複製網址。
將檔案上傳至複製的網址。
```
PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
```
更改下列內容：
- UPLOAD_FILE_PATH：上傳檔案的本機路徑。
- COPIED_URL：從預覽步驟複製的已簽署網址。
選用：重複步驟 3 到 6，在同一個匯入工作中建立更多資料檔案。

選用：取得匯入工作的全部資料檔案。

GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles

驗證匯入工作。

POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate

取得匯入工作並查看驗證報表。如果狀態為 READY，即可繼續進行下一個步驟。否則，您必須修正工作或特定檔案，這可能需要刪除檔案或上傳新檔案。
```
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
```

執行匯入工作。

POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run

取得匯入工作並查看執行報表。如果狀態為 COMPLETED，表示工作已順利執行。否則，如果工作失敗且處於終端狀態，執行報告會包含錯誤。建立新的匯入工作，並套用必要變更。
```
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
```

如果上傳檔案時發生問題，請參閱這篇文章，瞭解如何排解常見的錯誤訊息。

檢查上傳內容

上傳檔案後，遷移中心會驗證檔案，檢查格式是否正確。如果驗證成功，Migration Center 就會處理資料，建立新資產或更新現有資產。您可以在 Google Cloud 控制台中查看上傳工作的狀態。

如要查看上傳作業的狀態，請按照下列步驟操作：

前往「資料匯入」頁面，然後按一下「檔案上傳」。
在檔案匯入清單中，選取要查看的上傳作業。
在檔案上傳頁面的「資料匯入進度」下方，查看上傳檔案的「狀態」。

檔案會顯示下列其中一種狀態。

狀態清單

已完成：檔案匯入成功。
準備就緒。檔案已通過驗證，可以匯入。
待處理：您的檔案正在等待其他檔案處理完畢。
執行中：檔案正在處理中。
驗證。檔案處於驗證階段。
驗證失敗。檔案含有錯誤。修正錯誤後，請嘗試再次上傳檔案。
失敗。無法匯入檔案。

查看錯誤詳細資料

匯入檔案後，如果發生錯誤，可以直接在 Google Cloud 控制台中查看錯誤訊息。

如要查看上傳作業的錯誤，請按照下列步驟操作：

前往「資料匯入」頁面，然後按一下「檔案上傳」。
按一下顯示警告或錯誤的匯入檔案。匯入檔案詳細資料頁面會顯示完整的錯誤清單。

在匯入檔案詳細資料頁面中，您可以查看導致錯誤的資產和資料欄位，以及錯誤說明。檔案匯入工作發生錯誤，可能會導致遷移中心無法建立新資產，或使用新變更更新現有資產。如要修正錯誤，請編輯檔案並建立新的檔案匯入工作，然後重新上傳檔案。

如要進一步瞭解可能出現的錯誤訊息，請參閱「排解檔案匯入錯誤」。

匯入檔案規格

下表列出用於手動匯入的範本檔案技術規格。

「`vmInfo`」檔案

欄	預期類型	說明
MachineId	字串	虛擬機器的專屬 ID。
MachineName	字串	虛擬機器的顯示名稱。
PrimaryIPAddress	字串	機器的 IP 位址。
PrimaryMACAddress	字串	機器的 MAC 位址。這項資訊僅用於識別電腦。
PublicIPAddress	字串	機器的公開 IP 位址。
IpAddressListSemiColonDelimited	訊息清單	已分配或指派的網路位址清單。
TotalDiskAllocatedGiB	int64	磁碟總容量。
TotalDiskUsedGiB	int64	磁碟中已使用的空間總量。
MachineTypeLabel	字串	AWS 或 Azure 機型標籤。
AllocatedProcessorCoreCount	int64	虛擬機器的 CPU 核心數。
MemoryGiB	int32	虛擬機器的記憶體量。
HostingLocation	字串	AWS 或 Azure 格式的機器位置。
OsType	字串	電腦的作業系統。
OsName	字串	電腦的作業系統。
OsVersion	字串	電腦的作業系統版本。
MachineStatus	字串	電腦的電源狀態。
ProvisioningState	字串	佈建狀態 (僅限 Azure VM)。
CreateDate	時間戳記	機器的建立時間戳記。
IsPhysical	字串	機器是實體或虛擬機器。
來源	訊息	AWS 或 Azure 機器的來源詳細資料。

「`diskInfo`」檔案

欄	預期類型	說明
MachineId	字串	虛擬機器的專屬 ID。
DiskLabel	字串	磁碟標籤。
SizeInGib	int64	磁碟總容量。
UsedInGib	int64	磁碟中已使用的空間總量。
StorageTypeLabel	字串	磁碟標籤類型 (例如 BIOS 或 GPT)。

perfInfo 檔案

欄	預期類型	說明
MachineId	字串	虛擬機器的專屬 ID。
TimeStamp		收集樣本的時間戳記。
CpuUtilizationPercentage	浮點數	已使用的 CPU 總容量百分比。必須介於 0 到 100 之間。
MemoryUtilizationPercentage	浮點數	系統記憶體使用率。必須介於 0 到 100 之間。
UtilizedMemoryBytes	浮點數	以位元組為單位的記憶體總用量。
DiskReadOperationsPerSec	浮點數	在短時間內取樣的平均 IOPS。
DiskWriteOperationsPerSec	浮點數	在短時間內取樣的平均 IOPS。
NetworkBytesPerSecSent	浮點數	在短時間範圍內取樣的平均網路輸出量 (以 B/s 為單位)。
NetworkBytesPerSecReceived	浮點數	在短時間內取樣的平均網路輸入量 (以 B/s 為單位)。

tagInfo 檔案

欄	預期類型	說明
鍵	字串	屬性鍵。
值	字串	屬性值。

後續步驟

進一步瞭解遷移中心收集方法。
瞭解如何管理檔案上傳作業。

手動建立及上傳資料表 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

限制