手動建立及上傳資料表

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

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

  1. 可用範本清單下載範本。
  2. 手動在資料表中填入基礎架構的資料。
  3. 將資料表上傳至 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"

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

上傳資料表

如要上傳檔案,請按照下列步驟操作:

主控台

  1. 前往「資料匯入」頁面。

    前往「資料匯入」

  2. 依序點選「新增資料」>「上傳檔案」

  3. 在「設定檔案上傳」部分,輸入檔案上傳的名稱。

  4. 從「檔案格式」清單中,選取「手動填入的 CSV 範本」

  5. 按一下「選取要上傳的檔案」,然後選取要上傳的所有檔案。

  6. 按一下「上傳檔案」,確認並開始上傳檔案。

  7. 如果檔案通過驗證,請按一下「匯入資料」,然後按一下「確認」,即可從檔案建立素材資源。

API

  1. 建立匯入工作。

    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。
  2. 選用:如要確認匯入工作是否已正確建立,請取得匯入工作。

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
    
  3. 建立附加至匯入工作的匯入資料檔案。

    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_FORMATIMPORT_JOB_FORMAT_MANUAL_CSV
  4. 取得資料檔案。

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID
    
  5. 從回應的 signedUrl 欄位複製網址。

  6. 將檔案上傳至複製的網址。

    PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
    

    更改下列內容:

    • UPLOAD_FILE_PATH:上傳檔案的本機路徑。
    • COPIED_URL:從預覽步驟複製的已簽署網址。
  7. 選用:重複步驟 3 到 6,在同一個匯入工作中建立更多資料檔案。

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

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles
    
  9. 驗證匯入工作。

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

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
    
  11. 執行匯入工作。

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

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

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

檢查上傳內容

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

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

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

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

狀態清單

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

查看錯誤詳細資料

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

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

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

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

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

匯入檔案規格

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

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 檔案

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

後續步驟