Il Centro di migrazione consente di caricare le tabelle di dati da compilare manualmente utilizzando i modelli forniti. Questa operazione è utile se la tua infrastruttura ha un numero limitato di asset e vuoi creare manualmente i dati.
Per importare le tabelle compilate manualmente, esegui queste operazioni: passaggi:
- Scarica i modelli dal elenco di modelli disponibili.
- Compila manualmente le tabelle con i dati della tua infrastruttura.
- Carica le tabelle nel Migration Center.
Limitazioni
- La dimensione massima per il caricamento di un file è 100 MB.
Modelli di dati disponibili
La tabella seguente fornisce i modelli di file che puoi utilizzare per per caricare i dati dell'infrastruttura su Migration Center. I modelli contengono dati di esempio come suggerimento su come compilare la tabella. Per una descrizione dettagliata del formato dei dati richiesto, consulta Specifiche dei file di importazione.
| Nome file | Tipo di dati | Descrizione |
|---|---|---|
| vmInfo.csv | Informazioni sul computer | Utilizza questo modello per fornire informazioni sui singoli asset, tra cui CPU, memoria e altri parametri di configurazione. Questa tabella è obbligatoria ogni volta che crei una nuova importazione. |
| perfInfo.csv | Dati prestazioni | (Facoltativo) Utilizza questo modello per fornire i dati sul rendimento dei tuoi asset in un formato di serie temporali. |
| diskInfo.csv | Dati disco | (Facoltativo) Utilizza questo modello per fornire informazioni sui dischi e il loro utilizzo. |
| tagInfo.csv | Tag di sistema | (Facoltativo) Utilizza questo modello per assegnare etichette alle risorse. Le etichette devono rispettare i requisiti per le etichette in Google Cloud. |
Per ulteriori informazioni sulle specifiche di ciascun file, vedi Specifiche dei file di importazione.
Carica le tabelle
Per caricare i file:
Console
Vai alla pagina Importazione dati.
Fai clic su Aggiungi dati > Carica file.
Nella sezione Configura il caricamento dei file, inserisci il nome del caricamento dei file.
Nell'elenco Formato file, seleziona Modelli CSV compilati manualmente.
Fai clic su Seleziona file da caricare, poi seleziona tutti i file che vuoi caricare.
Per confermare e iniziare a caricare i file, fai clic su Carica file.
Se i file vengono convalidati correttamente, per creare gli asset dalla dei file, fai clic su Importa dati e poi su Conferma.
API
Crea un job di importazione.
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" }Sostituisci quanto segue:
PROJECT_ID: ID del progetto per creare del job di importazione.REGION: regione per creare il job di importazione.IMPORT_JOB_ID: ID del nuovo job di importazione.SOURCE_ID: ID di un'origine esistente da impostare associate al job di importazione.
(Facoltativo) Per verificare che il job di importazione sia stato creato correttamente, recupera il job di importazione.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Crea un file di dati di importazione allegato al job di importazione.
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" }Sostituisci quanto segue:
DATA_FILE_ID: ID del nuovo file di datiIMPORT_JOB_FORMAT:IMPORT_JOB_FORMAT_MANUAL_CSV
Recupera il file di dati.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID
Copia l'URL dal campo
signedUrldella risposta.Carica un file nell'URL copiato.
PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
Sostituisci quanto segue:
UPLOAD_FILE_PATH: il percorso locale del file caricato.COPIED_URL: l'URL firmato copiato dai passaggi di anteprima.
(Facoltativo) Ripeti i passaggi 3-6 per creare altri file di dati nello stesso del job di importazione.
(Facoltativo) Recupera tutti i file di dati di un job di importazione.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles
Convalida il job di importazione.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
Recupera il job di importazione e visualizza il report di convalida. Se lo stato è
READY, è possibile continuare con i passaggi successivi. In caso contrario, devi correggere il job o file specifici, il che potrebbe richiedere la cancellazione di file o il caricamento di nuovi file.GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Esegui il job di importazione.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run
Ottieni il job di importazione e visualizza il report di esecuzione. Se lo stato è
COMPLETED, il job è stato eseguito correttamente. Altrimenti, se il job non è riuscito ed è in uno stato terminale, il report di esecuzione include gli errori. Crea un nuovo job di importazione e applica le modifiche necessarie.GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Se riscontri problemi con il caricamento del file, scopri come risolvere i messaggi di errore comuni.
Rivedi il caricamento
Dopo aver caricato i file, il Centro migrazione li convalida per verificare che siano formalmente corretti. Se la convalida va a buon fine, Migration Center elabora i dati per creare nuovi asset o aggiornare quelli esistenti. Puoi controllare lo stato dei job di caricamento dall'apposita pagina della console Google Cloud.
Per esaminare lo stato del processo di caricamento:
- Vai alla pagina Importazione dati e fai clic su Caricamenti di file.
- Nell'elenco delle importazioni di file, seleziona il caricamento che vuoi esaminare.
- Nella pagina di caricamento del file, in Avanzamento importazione dati, Controlla lo stato dei file caricati.
Puoi visualizzare i file in uno dei seguenti stati.
Elenco di stati
- Completato. Importazione del file riuscita.
- Pronto. Il file ha superato la convalida ed è pronto per essere importato.
- In attesa. Il tuo file è in attesa del completamento dell'elaborazione di un altro file.
- In esecuzione. È in corso l'elaborazione del file.
- Convalida in corso.... Il file è in fase di convalida.
- Convalida non riuscita. Il file contiene alcuni errori. Correggi gli errori, quindi prova a caricare di nuovo il file.
- Non riuscita. Non è stato possibile importare il file.
Rivedi i dettagli dell'errore
Se riscontri errori dopo aver importato i file, puoi esaminare il messaggio di errore direttamente nella console Google Cloud.
Per esaminare gli errori del job di caricamento:
- Vai alla pagina Importazione dati e fai clic su Caricamenti di file.
- Fai clic sul file di importazione che mostra un avviso o un errore. La pagina dei dettagli del file di importazione mostra l'elenco completo degli errori.
Nella pagina dei dettagli del file di importazione, puoi esaminare gli asset e i campi di dati che causano gli errori e visualizzare una descrizione dell'errore. Gli errori nel job di importazione file potrebbero impedire al Centro di migrazione di creando nuovi asset o aggiorna quelli esistenti con le nuove modifiche. Per correggere l'errore, modifica i file e crea un nuovo job di importazione dei file per caricarli nuovamente.
Per ulteriori informazioni sui possibili messaggi di errore, consulta: Risolvere gli errori di importazione dei file.
Specifiche dei file di importazione
Le seguenti tabelle mostrano le specifiche tecniche per i file di modello utilizzati per l'importazione manuale.
File vmInfo
| Colonna | Tipo previsto | Descrizione |
|---|---|---|
| MachineId | string | L'identificatore univoco della macchina virtuale. |
| MachineName | string | Il nome visualizzato della macchina virtuale. |
| PrimaryIPAddress | string | L'indirizzo IP della macchina. |
| PrimaryMACAddress | string | L'indirizzo MAC della macchina. Viene utilizzato solo per identificare la macchina. |
| PublicIPAddress | string | L'indirizzo IP pubblico della macchina. |
| IpAddressListSemiColonDelimited | Elenco di messaggi | L'elenco di indirizzi di rete allocati o assegnati. |
| TotalDiskAllocatedGiB | int64 | La capacità totale del disco. |
| TotalDiskUsedGiB | int64 | La quantità totale di spazio utilizzato nel disco. |
| MachineTypeLabel | string | L'etichetta del tipo di macchina AWS o Azure. |
| AllocatedProcessorCoreCount | int64 | Numero di core della CPU nella macchina virtuale. |
| MemoryGiB | int32 | La quantità di memoria della macchina virtuale. |
| HostingLocation | string | La posizione della macchina in formato AWS o Azure. |
| OsType | string | Il sistema operativo della macchina. |
| NomeSistemaOperativo | string | Il sistema operativo della macchina. |
| OsVersion | string | La versione del sistema operativo della macchina. |
| MachineStatus | string | Lo stato di alimentazione della macchina. |
| ProvisioningState | string | Lo stato del provisioning, solo per le VM Azure. |
| CreateDate | Timestamp | Il timestamp di creazione della macchina. |
| IsPhysical | string | Se la macchina è fisica o virtuale. |
| Origine | messaggio | I dettagli dell'origine per le macchine AWS o Azure. |
File diskInfo
| Colonna | Tipo previsto | Descrizione |
|---|---|---|
| MachineId | string | L'identificatore univoco della macchina virtuale. |
| DiskLabel | string | L'etichetta del disco. |
| SizeInGib | int64 | La capacità totale del disco. |
| UsedInGib | int64 | La quantità totale di spazio utilizzato sul disco. |
| StorageTypeLabel | string | Il tipo di etichetta del disco (ad esempio BIOS o GPT). |
file perfInfo
| Colonna | Tipo previsto | Descrizione |
|---|---|---|
| MachineId | string | L'identificatore univoco della macchina virtuale. |
| TimeStamp | Timestamp di raccolta del campione. | |
| CpuUtilizationPercentage | float | La percentuale della capacità totale della CPU utilizzata. Deve essere compreso nell'intervallo 0-100. |
| MemoryUtilizationPercentage | float | La percentuale di memoria di sistema utilizzata. Deve essere compreso tra 0 e 100. |
| UtilizedMemoryBytes | float | La memoria totale utilizzata in byte. |
| DiskReadOperationsPerSec | float | Le IOPS medie campionate in un breve periodo di tempo. |
| DiskWriteOperationsPerSec | float | Le IOPS medie campionate in un breve periodo di tempo. |
| NetworkBytesPerSecSent | float | L'esportazione di rete media in B/s, campionata in un breve intervallo di tempo. |
| NetworkBytesPerSecReceived | float | Il traffico di rete in entrata medio in B/s, campionato in una finestra breve. |
file tagInfo
| Colonna | Tipo previsto | Descrizione |
|---|---|---|
| MachineId | string | L'identificatore univoco della macchina virtuale. |
| Chiave | string | La chiave dell'etichetta. |
| Valore | string | Il valore dell'etichetta. |
Algoritmo di analisi per le etichette
Le etichette caricate con il file tagInfo devono seguire le requisiti per le etichette in Google Cloud. Se l'etichetta non è conforme ai requisiti, il Centro migrazione utilizza la seguente strategia per convertirla:
- Solo per le chiavi, vengono rimossi tutti i caratteri iniziali che non sono lettere alfabeto inglese.
- Sostituisce tutte le lettere maiuscole con lettere minuscole.
- Sostituisce tutti i caratteri non validi con trattini bassi (
_). - Tronca l'etichetta a un massimo di 62 caratteri.
- Aggiunge il suffisso
_<CRC32>, calcolato in base alla stringa originale.
Ogni volta che un'etichetta viene convertita viene visualizzato un messaggio di avviso.
Se la convalida non va a buon fine o se la chiave esiste già, l'importazione salta la riga e viene visualizzato un messaggio di avviso.
Passaggi successivi
- Scopri di più su Metodi di raccolta del Centro di migrazione.
- Scopri come gestire i caricamenti di file.