Manuell generierte Tabellen importieren

Im Migrationscenter können Sie Tabellen mit Daten hochladen, die Sie mithilfe der bereitgestellten Vorlagen manuell ausfüllen. Das ist nützlich, wenn Ihre Infrastruktur eine begrenzte Anzahl von Assets hat und Sie die Daten manuell erstellen möchten.

So importieren Sie die Tabellen, die Sie manuell ausgefüllt haben:

Laden Sie die Vorlagen aus der Liste der verfügbaren Vorlagen herunter.
Tragen Sie die Tabellen aus Ihrer Infrastruktur manuell in die Tabellen ein.
Laden Sie die Tabellen in das Migrationscenter hoch.

Beschränkungen

Die maximale Größe für einen Dateiupload beträgt 100 MB.

Verfügbare Datenvorlagen

Die folgende Tabelle enthält die Dateivorlagen, mit denen Sie Ihre Infrastrukturdaten in das Migrationscenter hochladen können. Die Vorlagen enthalten Beispieldaten zum Vorschlagen der Tabelle. Eine detaillierte Beschreibung des erforderlichen Datenformats finden Sie unter Dateien importieren.

Dateiname	Datentyp	Beschreibung
vmInfo.csv	Gerätedaten	Verwenden Sie diese Vorlage, um Informationen zu einzelnen Assets anzugeben, einschließlich CPU, Arbeitsspeicher und anderen Konfigurationsparametern. Diese Tabelle ist jedes Mal erforderlich, wenn Sie einen neuen Import erstellen.
perfInfo.csv	Leistungsdaten	Optional: Verwenden Sie diese Vorlage, um Leistungsdaten für Ihre Assets in einem Zeitreihenformat bereitzustellen.
diskInfo.csv	Laufwerksdaten	Optional: Verwenden Sie diese Vorlage, um Informationen zu Laufwerken und ihrer Auslastung anzugeben.
tagInfo.csv.	System-Tags	Optional: Mit dieser Vorlage kannst du den Assets Labels zuweisen. Labels müssen die Anforderungen für Labels in Google Cloud erfüllen.

Weitere Informationen zu den Spezifikationen für die einzelnen Dateien finden Sie unter Dateispezifikationen importieren.

Tabellen hochladen

So laden Sie die Dateien hoch:

Console

Rufen Sie die Seite Datenimport auf.

Zu „Datenimport“
Klicken Sie auf Daten hinzufügen. Eine neue Seite wird geöffnet.
Wählen Sie Dateien hochladen aus und geben Sie unter Datei-Upload einrichten den Namen des Datei-Uploads ein.
Wählen Sie in der Liste Manuell ausgefüllte CSV-Vorlagen aus.
Klicken Sie auf Dateien zum Hochladen auswählen und wählen Sie dann alle Dateien aus, die Sie hochladen möchten.
Klicken Sie zum Bestätigen und Hochladen der Dateien auf Dateien hochladen.
Wenn die Dateien korrekt validiert wurden, klicken Sie auf Daten importieren und dann auf Bestätigen, um die Assets aus den Dateien zu erstellen.

API

Erstellen Sie einen Importjob.
```
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"
}
```
Dabei gilt:
- PROJECT_ID: ID des Projekts, in dem der Importjob erstellt wird.
- REGION: Region zum Erstellen des Importjobs.
- IMPORT_JOB_ID: ID des neuen Importjobs.
- SOURCE_ID: ID einer vorhandenen Quelle, die dem Importjob zugeordnet werden soll.

Optional: Rufen Sie den Importjob ab, um zu prüfen, ob der Importjob korrekt erstellt wurde.

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

Erstellen Sie eine Importdatendatei, die an den Importjob angehängt ist.

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

Dabei gilt:

DATA_FILE_ID: ID der neuen Datendatei
IMPORT_JOB_FORMAT: IMPORT_JOB_FORMAT_MANUAL_CSV

Rufen Sie die Datendatei ab.

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

Kopieren Sie die URL aus dem Feld signedUrl aus der Antwort.
Laden Sie eine Datei in die kopierte URL hoch.
```
PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
```
Dabei gilt:
- UPLOAD_FILE_PATH: Der lokale Pfad der hochgeladenen Datei.
- COPIED_URL: Die kopierte signierte URL aus den Vorschauschritten.
Optional: Wiederholen Sie die Schritte 3 bis 6, um weitere Datendateien unter demselben Importjob zu erstellen.

Optional: Alle Datendateien eines Importjobs abrufen.

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

Prüfen Sie den Importjob.

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

Rufen Sie den Importjob ab und rufen Sie den Validierungsbericht auf. Wenn der Status READY lautet, können Sie mit den nächsten Schritten fortfahren. Andernfalls müssen Sie den Job oder bestimmte Dateien korrigieren. Möglicherweise müssen Sie Dateien löschen oder neue hochladen.
```
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
```

Führen Sie den Importjob aus.

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

Rufen Sie den Importjob ab und rufen Sie den Ausführungsbericht auf. Wenn der Status COMPLETED lautet, wurde der Job erfolgreich ausgeführt. Wenn der Job fehlgeschlagen ist und sich im Terminalstatus befindet, enthält der Ausführungsbericht die Fehler. Erstellen Sie einen neuen Importjob und wenden Sie die erforderlichen Änderungen an.
```
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
```

Falls beim Hochladen von Dateien Probleme auftreten, lesen Sie die Informationen zum Beheben häufiger Fehlermeldungen.

Upload überprüfen

Nachdem Sie Ihre Dateien hochgeladen haben, überprüft das Migrationscenter, ob sie offiziell korrekt sind. Wenn die Überprüfung erfolgreich ist, verarbeitet das Migrationscenter die Daten, um neue Assets zu erstellen oder vorhandene zu aktualisieren. Sie können den Status Ihrer Uploadjobs über die Google Cloud Console prüfen.

So prüfen Sie den Status Ihres Uploadjobs:

Rufen Sie die Seite Datenimport auf und klicken Sie auf Dateiuploads.
Wählen Sie in der Liste der Dateiimporte den Upload aus, den Sie prüfen möchten.
Prüfen Sie auf der Seite für den Dateiupload unter Fortschritt des Datenimports den Status der hochgeladenen Dateien.

Sie können Ihre Dateien mit einem der folgenden Status ansehen:

Liste der Status

Abgeschlossen. Die Datei wurde importiert.
Bereit: Ihre Datei hat die Validierung bestanden und kann importiert werden.
Ausstehend. Ihre Datei wartet auf die Verarbeitung einer anderen Datei.
Läuft: Ihre Datei wird verarbeitet.
Wird validiert. Die Datei befindet sich in der Validierungsphase.
Validierung fehlgeschlagen: Die Datei enthält einige Fehler. Beheben Sie die Fehler und versuchen Sie die Datei noch einmal hochzuladen.
Fehlgeschlagen. Die Datei konnte nicht importiert werden.

Fehlerdetails ansehen

Falls nach dem Importieren der Dateien Fehler auftreten, können Sie die Fehlermeldung direkt in der Google Cloud Console prüfen.

So überprüfen Sie die Fehler des Uploadjobs:

Rufen Sie die Seite Datenimport auf und klicken Sie auf Dateiuploads.
Klicken Sie in der Spalte Fehler auf Anzeigen. Die vollständige Liste der Fehler wird auf der Seite Fehlerdetails angezeigt.

Auf der Seite Fehlerdetails können Sie die Assets und Datenfelder prüfen, die die Fehler verursachen, und eine Beschreibung des Fehlers aufrufen. Fehler im Dateiimportjob können verhindern, dass das Migrationscenter neue Assets erstellt oder vorhandene mit den neuen Änderungen aktualisiert. Beheben Sie den Fehler, indem Sie Ihre Dateien bearbeiten und einen neuen Dateiimportjob erstellen, um sie noch einmal hochzuladen.

Weitere Informationen zu den möglichen Fehlermeldungen finden Sie unter Fehlerbehebung beim Importieren von Dateien.

Spezifikationen für den Import von Dateien

Die folgenden Tabellen zeigen die technischen Spezifikationen für die Vorlagendateien, die für den manuellen Import verwendet werden.

Datei `vmInfo`

Spalte	Erwarteter Typ	Beschreibung
Maschinen-ID	String	Die eindeutige Kennung der virtuellen Maschine.
Maschinenname	String	Der Anzeigename der virtuellen Maschine.
Primäre IP-Adresse	String	Die IP-Adresse des Computers.
Primäre MAC-Adresse	String	Die MAC-Adresse des Computers. Sie wird nur verwendet, um die Maschine zu identifizieren.
ÖffentlicheIP-Adresse	String	Die öffentliche IP-Adresse des Computers.
IpAddressListSemiColonDelimited	Liste der Nachrichten	Die Liste der zugewiesenen oder zugewiesenen Netzwerkadressen.
TotalDiskAllocationsGiB	int64	Die Gesamtkapazität des Laufwerks.
TotalDiskUsedGiB	int64	Der insgesamt belegte Speicherplatz auf dem Laufwerk.
Maschinentyplabel	String	Das Label des AWS- oder Azure-Maschinentyps.
ZugewiesenerProzessorprozessor Anzahl	int64	Anzahl der CPU-Kerne in der virtuellen Maschine.
Arbeitsspeicher GiB	int32	Die Größe des Arbeitsspeichers der virtuellen Maschine.
HostingStandort	String	Der Standort der Maschine im AWS- oder Azure-Format.
OsType	String	Das Betriebssystem des Computers.
Name des Betriebssystems	String	Das Betriebssystem des Computers.
Betriebssystemversion	String	Die Version des Betriebssystems des Computers.
Maschinenstatus	String	Die Stromversorgung der Maschine.
ProvisioningState	String	Der Bereitstellungsstatus, nur für Azure-VMs.
Erstellungsdatum	Zeitstempel	Der Zeitstempel für die Erstellung der Maschine.
Isphäre	String	Wenn die Maschine eine physische oder virtuelle Maschine ist.
Quelle	nachricht	Die Details der Quelle für AWS- oder Azure-Maschinen.

Datei `diskInfo`

Spalte	Erwarteter Typ	Beschreibung
Maschinen-ID	String	Die eindeutige Kennung der virtuellen Maschine.
DiskLabel	String	Das Laufwerklabel.
GrößeInGib	int64	Die Gesamtkapazität des Laufwerks.
VerwendetInGib	int64	Der insgesamt belegte Speicherplatz auf dem Laufwerk.
Speichertyplabel	String	Der Labeltyp des Laufwerks (z. B. BIOS oder GPT).

PerfInfo-Datei

Spalte	Erwarteter Typ	Beschreibung
Maschinen-ID	String	Die eindeutige Kennung der virtuellen Maschine.
TimeStamp		Zeitstempel für die Erfassung der Stichprobe
CPU-Auslastung in %	float	Der Prozentsatz der insgesamt verwendeten CPU-Kapazität. Er muss im Intervall 0–100 liegen.
Arbeitsspeichernutzung in %	float	Der Prozentsatz des verwendeten Systemspeichers. Er muss im Intervall 0–100 liegen.
UtilizedMemoryBytes	float	Der insgesamt in Byte verwendete Arbeitsspeicher.
DiskReadOperationsPerSec	float	Die durchschnittlichen IOPS in einem kurzen Fenster.
DiskWriteOperationsPerSec	float	Die durchschnittlichen IOPS in einem kurzen Fenster.
Netzwerkbyte-Sek. (gesendet)	float	Der durchschnittliche ausgehende Netzwerktraffic in B/s, abgetastet über ein kurzes Fenster.
Netzwerkbyte-Sek. empfangen	float	Der durchschnittliche eingehende Netzwerktraffic in B/s, abgetastet über ein kurzes Fenster.

TagInfo-Datei

Spalte	Erwarteter Typ	Beschreibung
Maschinen-ID	String	Die eindeutige Kennung der virtuellen Maschine.
Schlüssel	String	Der Labelschlüssel.
Wert	String	Der Wert des Labels

Parsing-Algorithmus für Labels

Die Labels, die Sie mit der tagInfo-Datei hochladen, müssen die Anforderungen für Labels in Google Cloud erfüllen. Wenn das Label die Anforderungen nicht erfüllt, konvertiert das Migrationscenter mit der folgenden Strategie:

Bei Schlüsseln werden alle führenden Zeichen entfernt, die keine Buchstaben des englischen Alphabets sind.
Er ersetzt alle Großbuchstaben durch Kleinbuchstaben.
Er ersetzt alle ungültigen Zeichen durch Unterstriche (_).
Dabei wird das Label auf maximal 62 Zeichen gekürzt.
Dadurch wird das Suffix _<CRC32> hinzugefügt, das auf der Grundlage des ursprünglichen Strings berechnet wird.

Bei jeder Konvertierung eines Labels wird eine Warnmeldung angezeigt.

Wenn die Validierung fehlschlägt oder der Schlüssel bereits vorhanden ist, überspringt der Import die Zeile und eine Warnmeldung wird angezeigt.