匯入手動產生的資料表

移轉中心可讓你上傳資料表，並使用提供的範本手動填入資料。如果基礎架構中的資產數量有限，且您想手動建立資料，這項功能就很實用。

如要匯入手動填入的表格，請執行下列步驟：

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

限制

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

可用的資料範本

下表提供可用來將基礎架構資料上傳至遷移中心的檔案範本。範本中包含範例資料，可提供填入表格的建議。如需詳細的資料格式說明，請參閱匯入檔案規格。

檔案名稱 資料類型 說明
vmInfo.csv 電腦資訊 您可以使用這個範本提供個別資產的資訊，包括 CPU、記憶體和其他設定參數。每次建立新的匯入作業時，都必須使用這個表格。
perfInfo.csv 效能資料 選用步驟：使用這個範本，以時序資料格式提供素材資源的成效資料。
diskInfo.csv 磁碟資料 選用：使用這個範本提供磁碟和磁碟用量資訊。
tagInfo.csv 系統標記 選用：使用這個範本為資產指派標籤。標籤必須符合 Google Cloud 中的標籤規定。

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

上傳資料表

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

主控台

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

    前往「資料匯入」

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

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

  4. 從「File format」(檔案格式) 清單中選取「Manually populated CSV templates」(手動填入的 CSV 範本)。

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

  6. 如要確認並開始上傳檔案，請按一下「上傳檔案」。

  7. 如果檔案驗證成功，請按一下「Import data」，然後點選「Confirm」，即可根據檔案建立素材資源。

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_FORMAT： IMPORT_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. 按一下顯示警告或錯誤的匯入檔案。「Import file details」(匯入檔案詳細資料) 頁面會顯示完整的錯誤清單。

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

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

匯入檔案規格

下表列出手動匯入作業所使用的範本檔案技術規格。

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

欄 預期類型 說明
MachineId 字串 虛擬機器的專屬 ID。
鍵 字串 標籤鍵。
值 字串 標籤值。

標籤的剖析演算法

您透過 tagInfo 檔案上傳的標籤必須符合 Google Cloud中的標籤規定。如果標籤不符合規定，Migration Center 會使用下列策略轉換標籤：

  1. 只針對鍵盤，移除所有非英文字母的開頭字元。
  2. 會將所有大寫字母替換為小寫字母。
  3. 它會將所有無效字元替換為底線 (_)。
  4. 系統會將標籤截斷至最多 62 個半形字元的長度。
  5. 它會根據原始字串計算並新增 _<CRC32> 後置字串。

每次轉換標籤時，系統都會顯示警告訊息。

如果驗證失敗或鍵值已存在，匯入作業會略過該列，並顯示警告訊息。

後續步驟