Halaman ini diterjemahkan oleh Cloud Translation API.

Mengimpor 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 data 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 Migration Center.

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. Template berisi data contoh sebagai saran tentang cara mengisi tabel. Untuk deskripsi mendetail tentang format data yang diperlukan, lihat Spesifikasi file impor.

Nama file	Data type	Deskripsi
vmInfo.csv	Informasi perangkat	Gunakan template ini untuk memberikan informasi tentang setiap aset, 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 memberikan data performa untuk 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 ke aset. Label harus mengikuti persyaratan untuk label di Google Cloud.

Untuk mengetahui informasi selengkapnya tentang spesifikasi untuk setiap file, lihat Spesifikasi file impor.

Mengupload tabel

Untuk mengupload file, ikuti langkah-langkah berikut:

Konsol

Buka halaman Impor data.

Buka Impor data
Klik Tambahkan data > Upload file.
Di bagian Siapkan upload file, masukkan nama upload file.
Dari daftar Format file, pilih Template CSV yang diisi secara manual.
Klik Pilih file untuk diupload, lalu pilih semua file yang ingin diupload.
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 ada yang akan dikaitkan dengan tugas impor.

Opsional: Untuk mengonfirmasi bahwa tugas impor 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 yang ditandatangani dan disalin dari langkah pratinjau.
Opsional: Ulangi langkah 3-6 untuk membuat lebih banyak file data dalam tugas impor yang sama.

Opsional: Mendapatkan 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 harus memperbaiki tugas atau file tertentu, yang mungkin memerlukan penghapusan file atau upload 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 eksekusinya. Jika statusnya COMPLETED, tugas berhasil dieksekusi. Jika tidak, 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.

Meninjau upload

Setelah Anda mengupload file, Pusat Migrasi akan memvalidasinya untuk memeriksa apakah file tersebut sudah benar secara formal. Jika validasi berhasil, Migration Center akan memproses data untuk membuat aset baru, atau memperbarui aset yang 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 untuk 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 sedang menunggu file lain selesai diproses.
Berlari. File Anda sedang diproses.
Memvalidasi. File Anda sedang dalam tahap validasi.
Validasi gagal. File Anda berisi beberapa error. Perbaiki error, lalu coba upload file Anda lagi.
Gagal. File Anda tidak dapat diimpor.

Meninjau detail error

Jika mengalami error setelah mengimpor file, Anda dapat meninjau pesan error langsung di konsol Google Cloud.

Untuk meninjau error 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 Migration Center membuat aset baru atau memperbarui aset yang ada dengan perubahan baru. Untuk memperbaiki error, 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 mesin. 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 disk.
MachineTypeLabel	string	Label jenis mesin AWS atau Azure.
AllocatedProcessorCoreCount	int64	Jumlah core CPU di virtual machine.
MemoryGiB	int32	Jumlah memori virtual machine.
HostingLocation	string	Lokasi mesin dalam format AWS atau Azure.
OsType	string	OS mesin.
OsName	string	OS mesin.
OsVersion	string	Versi OS mesin.
MachineStatus	string	Status daya mesin.
ProvisioningState	string	Status penyediaan, hanya untuk VM Azure.
CreateDate	Stempel waktu	Stempel waktu pembuatan mesin.
IsPhysical	string	Apakah mesin tersebut adalah mesin fisik atau virtual.
Sumber	message	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 disk.
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	IOPS rata-rata yang diambil sampelnya dalam jangka waktu singkat.
DiskWriteOperationsPerSec	float	IOPS rata-rata yang diambil sampelnya dalam jangka waktu singkat.
NetworkBytesPerSecSent	float	Traffic keluar jaringan rata-rata dalam B/s, yang diambil sampelnya selama jangka waktu singkat.
NetworkBytesPerSecReceived	float	Ingress jaringan rata-rata dalam B/s, yang diambil sampelnya selama jangka waktu singkat.

file tagInfo

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

Algoritme penguraian untuk label

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

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

Pesan peringatan akan 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 lebih lanjut metode pengumpulan Migration Center.
Pelajari cara mengelola upload file.