Impor tabel yang dibuat secara manual

Pusat Migrasi memungkinkan Anda mengupload tabel data yang Anda isi secara manual menggunakan template yang disediakan. Hal ini berguna jika infrastruktur Anda memiliki jumlah aset yang terbatas dan Anda ingin membuat datanya secara manual.

Untuk mengimpor tabel yang Anda isi secara manual, lakukan langkah-langkah berikut:

Download template dari daftar template yang tersedia.
Isi tabel secara manual dengan data dari infrastruktur Anda.
Upload tabel ke Pusat Migrasi.

Batasan

Ukuran maksimum untuk upload file adalah 100 Mb.

Template data yang tersedia

Tabel berikut menyediakan template file yang dapat Anda gunakan untuk mengupload data infrastruktur ke Pusat Migrasi. {i>Template<i} ini berisi data sampel sebagai saran tentang cara mengisi tabel. Untuk deskripsi mendetail tentang format data yang diperlukan, lihat Mengimpor spesifikasi file.

Nama file	Data type	Deskripsi
vmInfo.csv	Informasi perangkat	Gunakan template ini untuk memberikan informasi tentang aset individual, termasuk CPU, memori, dan parameter konfigurasi lainnya. Tabel ini diperlukan setiap kali Anda membuat impor baru.
perfInfo.csv	Data performa	Opsional: Gunakan template ini untuk menyediakan data performa aset Anda dalam format deret waktu.
diskInfo.csv	Data disk	Opsional: Gunakan template ini untuk memberikan informasi tentang disk dan penggunaannya.
tagInfo.csv	Tag sistem	Opsional: Gunakan template ini untuk menetapkan label pada aset. Label harus mengikuti persyaratan untuk label di Google Cloud.

Untuk mengetahui informasi selengkapnya tentang spesifikasi setiap file, lihat Mengimpor spesifikasi file.

Upload tabel

Untuk mengupload file, ikuti langkah-langkah berikut:

Konsol

Buka halaman Impor data.

Buka Impor data
Klik Tambahkan data. Halaman baru akan terbuka.
Pilih Upload files lalu, di bagian Set up file upload, masukkan nama upload file.
Dari daftar, pilih Template CSV yang diisi secara manual.
Klik Select files to upload, lalu pilih semua file yang ingin Anda upload.
Untuk mengonfirmasi dan mulai mengupload file, klik Upload file.
Jika file divalidasi dengan benar, untuk membuat aset dari file, klik Import data, lalu klik Confirm.

API

Buat tugas impor.
```
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"
}
```
Ganti kode berikut:
- PROJECT_ID: ID project untuk membuat tugas impor.
- REGION: Region untuk membuat tugas impor.
- IMPORT_JOB_ID: ID tugas impor baru.
- SOURCE_ID: ID sumber yang sudah ada yang akan dikaitkan dengan tugas impor.

Opsional: Untuk mengonfirmasi bahwa tugas impor telah dibuat dengan benar, dapatkan tugas impor.

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

Buat file data impor yang dilampirkan ke tugas impor.

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

Ganti kode berikut:

DATA_FILE_ID: ID file data baru
IMPORT_JOB_FORMAT.IMPORT_JOB_FORMAT_MANUAL_CSV

Dapatkan file data.

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

Salin URL dari kolom signedUrl dari respons.
Upload file ke URL yang disalin.
```
PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
```
Ganti kode berikut:
- UPLOAD_FILE_PATH: Jalur lokal file yang diupload.
- COPIED_URL: URL bertanda tangan yang disalin dari langkah pratinjau.
Opsional: Ulangi langkah 3–6 untuk membuat lebih banyak file data dengan tugas impor yang sama.

Opsional: Dapatkan semua file data tugas impor.

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

Validasi tugas impor.

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

Dapatkan tugas impor dan lihat laporan validasi. Jika statusnya READY, Anda dapat melanjutkan ke langkah berikutnya. Jika tidak, Anda perlu memperbaiki tugas atau file tertentu, tindakan ini mungkin mengharuskan menghapus file atau mengupload file baru.
```
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
```

Jalankan tugas impor.

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

Dapatkan tugas impor dan lihat laporan eksekusi. Jika statusnya adalah COMPLETED, artinya tugas berhasil dieksekusi. Atau, jika tugas gagal dan dalam status terminal, laporan eksekusi akan menyertakan error. Buat tugas impor baru dan terapkan perubahan yang diperlukan.
```
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
```

Jika Anda mengalami masalah saat mengupload file, lihat cara memecahkan masalah pesan error umum.

Tinjau upload

Setelah Anda mengupload file, Pusat Migrasi akan memvalidasinya untuk memeriksa apakah file tersebut benar secara formal. Jika validasi berhasil, Pusat Migrasi akan memproses data untuk membuat aset baru, atau memperbarui aset yang sudah ada. Anda dapat memeriksa status tugas upload dari Konsol Google Cloud.

Untuk meninjau status tugas upload Anda, ikuti langkah-langkah berikut:

Buka halaman Impor data, lalu klik Upload file.
Dari daftar impor file, pilih upload yang ingin Anda tinjau.
Di halaman upload file, di bagian Progres impor data, tinjau Status file yang Anda upload.

Anda dapat melihat file dalam salah satu status berikut.

Daftar status

Selesai. Impor file Anda berhasil.
Siap. File Anda lulus validasi, dan siap diimpor.
Tertunda. File Anda menunggu file lain selesai diproses.
Berjalan. File Anda sedang diproses.
Memvalidasi. File Anda berada dalam tahap validasi.
Validasi gagal. File Anda berisi beberapa kesalahan. Perbaiki kesalahan tersebut, lalu coba upload file Anda lagi.
Gagal. File Anda tidak dapat diimpor.

Tinjau detail error

Jika menemukan error setelah mengimpor file, Anda dapat meninjau pesan error secara langsung di Konsol Google Cloud.

Untuk meninjau error pada tugas upload, ikuti langkah-langkah berikut:

Buka halaman Impor data, lalu klik Upload file.
Klik file impor yang menampilkan peringatan atau error. Halaman detail file impor menampilkan daftar lengkap error.

Di halaman detail file impor, Anda dapat meninjau aset dan kolom data yang menyebabkan error, serta melihat deskripsi error. Error dalam tugas impor file dapat mencegah Pusat Migrasi membuat aset baru atau memperbarui aset yang ada dengan perubahan baru. Untuk memperbaiki error ini, edit file Anda dan buat tugas impor file baru untuk menguploadnya lagi.

Untuk mengetahui informasi selengkapnya tentang kemungkinan pesan error, lihat Memecahkan masalah error impor file.

Spesifikasi file impor

Tabel berikut menunjukkan spesifikasi teknis untuk file template yang digunakan untuk impor manual.

File `vmInfo`

Kolom	Jenis yang diharapkan	Deskripsi
MachineId	string	ID unik virtual machine.
MachineName	string	Nama tampilan virtual machine.
PrimaryIPAddress	string	Alamat IP mesin.
PrimaryMACAddress	string	Alamat MAC komputer. ID ini hanya digunakan untuk mengidentifikasi mesin.
PublicIPAddress	string	Alamat IP publik komputer.
IpAddressListSemiColonDelimited	Daftar pesan	Daftar alamat jaringan yang dialokasikan atau ditetapkan.
TotalDiskAllocatedGiB	int64	Total kapasitas disk.
TotalDiskUsedGiB	int64	Jumlah total ruang yang digunakan di {i>disk<i}.
MachineTypeLabel	string	Label jenis mesin AWS atau Azure.
AllocatedProcessorCoreCount	int64	Jumlah inti CPU di virtual machine.
MemoryGiB	int32	Jumlah memori virtual machine.
HostingLocation	string	Lokasi perangkat dalam format AWS atau Azure.
OsType	string	OS komputer tersebut.
OsName	string	OS komputer tersebut.
OsVersion	string	Versi OS komputer.
MachineStatus	string	Status daya mesin.
ProvisioningState	string	Status penyediaan, khusus untuk VM Azure.
CreateDate	Stempel waktu	Stempel waktu pembuatan mesin.
IsPhysical	string	Jika mesin adalah mesin fisik atau virtual.
Asal	pesan	Detail sumber untuk mesin AWS atau Azure.

File `diskInfo`

Kolom	Jenis yang diharapkan	Deskripsi
MachineId	string	ID unik virtual machine.
DiskLabel	string	Label disk.
SizeInGib	int64	Total kapasitas disk.
UsedInGib	int64	Jumlah total ruang yang digunakan di {i>disk<i}.
StorageTypeLabel	string	Jenis label disk (misalnya, BIOS atau GPT).

File perfInfo

Kolom	Jenis yang diharapkan	Deskripsi
MachineId	string	ID unik virtual machine.
TimeStamp		Stempel waktu saat sampel dikumpulkan.
CpuUtilizationPercentage	float	Persentase total kapasitas CPU yang digunakan. Nilainya harus dalam interval 0-100.
MemoryUtilizationPercentage	float	Persentase memori sistem yang digunakan. Nilainya harus dalam interval 0-100.
UtilizedMemoryBytes	float	Total memori yang digunakan dalam byte.
DiskReadOperationsPerSec	float	Rata-rata IOPS yang diambil sampelnya selama periode singkat.
DiskWriteOperationsPerSec	float	Rata-rata IOPS yang diambil sampelnya selama periode singkat.
NetworkBytesPerSecSent	float	Traffic keluar jaringan rata-rata dalam B/dtk, yang diambil sampelnya selama periode singkat.
NetworkBytesPerSecReceived	float	Traffic masuk jaringan rata-rata dalam B/dtk, yang diambil sampelnya selama periode singkat.

File tagInfo

Kolom	Jenis yang diharapkan	Deskripsi
MachineId	string	ID unik virtual machine.
Kunci	string	Kunci label.
Nilai	string	Nilai label.

Algoritma penguraian untuk label

Label yang Anda upload dengan file tagInfo harus mengikuti persyaratan untuk label di Google Cloud. Jika label tidak sesuai dengan persyaratan, Pusat Migrasi akan menggunakan strategi berikut untuk mengonversi label:

Hanya untuk kunci, opsi ini akan menghapus semua karakter utama yang bukan huruf dari alfabet bahasa Inggris.
Mengganti semua huruf besar dengan huruf kecil.
Karakter ini mengganti semua karakter yang tidak valid dengan garis bawah (_).
Fungsi ini akan memotong label hingga maksimum 62 karakter.
Kode ini menambahkan akhiran _<CRC32>, yang dihitung berdasarkan string asli.

Pesan peringatan muncul setiap kali label dikonversi.

Jika validasi gagal atau jika kunci sudah ada, impor akan melewati baris dan pesan peringatan akan muncul.

Langkah selanjutnya

Pelajari metode pengumpulan Pusat Migrasi lebih lanjut.
Pelajari cara mengelola upload file Anda.