Manuell erstellte Tabellen importieren

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

So importieren Sie die manuell ausgefüllten Tabellen:

  1. Laden Sie die Vorlagen aus der Liste der verfügbaren Vorlagen herunter.
  2. Füllen Sie die Tabellen manuell mit den Daten aus Ihrer Infrastruktur aus.
  3. 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

In der folgenden Tabelle finden Sie die Dateivorlagen, mit denen Sie Ihre Infrastrukturdaten in das Migrationscenter hochladen können. Die Vorlagen enthalten Beispieldaten als Vorschlag, wie die Tabelle ausgefüllt werden kann. Eine detaillierte Beschreibung des erforderlichen Datenformats finden Sie unter Spezifikationen für Importdateien.

Dateiname Datentyp Beschreibung
vmInfo.csv Gerätedaten Verwenden Sie diese Vorlage, um Informationen zu einzelnen Assets bereitzustellen, einschließlich CPU-, Arbeitsspeicher- und anderer Konfigurationsparameter. 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 Laufwerkdaten Optional: Verwenden Sie diese Vorlage, um Informationen zu Laufwerken und ihrer Auslastung bereitzustellen.
tagInfo.csv System-Tags Optional: Verwenden Sie diese Vorlage, um den Assets Labels zuzuweisen. Labels müssen den Anforderungen an Labels in Google Cloud entsprechen.

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

Tabellen hochladen

So laden Sie die Dateien hoch:

Console

  1. Rufen Sie die Seite Datenimport auf.

    Zu „Datenimport“

  2. Klicken Sie auf Daten hinzufügen > Dateien hochladen.

  3. Geben Sie im Bereich Dateiupload einrichten den Namen des Dateiuploads ein.

  4. Wählen Sie in der Liste Dateiformat die Option Manuell ausgefüllte CSV-Vorlagen aus.

  5. Klicken Sie auf Dateien zum Hochladen auswählen und wählen Sie dann alle Dateien aus, die Sie hochladen möchten.

  6. Klicken Sie auf Dateien hochladen, um den Upload zu bestätigen und zu starten.

  7. 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

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

    Ersetzen Sie Folgendes:

    • PROJECT_ID: ID des Projekts, in dem der Importauftrag erstellt werden soll.
    • REGION: Region, in der der Importauftrag erstellt werden soll.
    • IMPORT_JOB_ID: ID des neuen Importjobs.
    • SOURCE_ID: ID einer vorhandenen Quelle, die dem Importauftrag zugeordnet werden soll.

  2. Optional: Rufen Sie den Importjob ab, um zu prüfen, ob er richtig erstellt wurde.

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

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

    Ersetzen Sie Folgendes:

    • DATA_FILE_ID: ID der neuen Datendatei
    • IMPORT_JOB_FORMAT: IMPORT_JOB_FORMAT_MANUAL_CSV

  4. Rufen Sie die Datendatei ab.

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

  5. Kopieren Sie die URL aus dem Feld signedUrl der Antwort.

  6. Laden Sie eine Datei über die kopierte URL hoch.

    PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'

    Ersetzen Sie Folgendes:

    • UPLOAD_FILE_PATH: Der lokale Pfad der hochgeladenen Datei.
    • COPIED_URL: Die kopierte signierte URL aus den vorherigen Schritten.

  7. Optional: Wiederholen Sie die Schritte 3 bis 6, um weitere Datendateien im selben Importauftrag zu erstellen.

  8. Optional: Alle Datendateien eines Importjobs abrufen.

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

  9. Validieren Sie den Importjob.

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

  10. Rufen Sie den Importjob ab und sehen Sie sich den Validierungsbericht an. 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

  11. Führen Sie den Importjob aus.

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

  12. Rufen Sie den Importjob und den Ausführungsbericht auf. Wenn der Status COMPLETED lautet, wurde der Job erfolgreich ausgeführt. Andernfalls, wenn der Job fehlgeschlagen ist und sich in einem Endstatus 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

Wenn beim Hochladen Ihrer Datei Probleme auftreten, finden Sie hier Informationen zur Fehlerbehebung bei häufigen Fehlermeldungen.

Upload prüfen

Nachdem Sie Ihre Dateien hochgeladen haben, werden sie im Migrationscenter auf formale Richtigkeit geprüft. Ist die Validierung erfolgreich, werden die Daten in Migration Center verarbeitet, um neue Assets zu erstellen oder vorhandene zu aktualisieren. Sie können den Status Ihrer Uploadjobs in der Google Cloud Console prüfen.

So prüfen Sie den Status Ihres Uploadjobs:

  1. Rufen Sie die Seite Datenimport auf und klicken Sie dann auf Dateiuploads.
  2. Wählen Sie in der Liste der Dateiimporte den Upload aus, den Sie überprüfen möchten.
  3. Prüfen Sie auf der Seite „Dateiupload“ unter Fortschritt des Datenimports den Status Ihrer hochgeladenen Dateien.

Ihre Dateien können einen der folgenden Status haben.

Liste der Status

  • Abgeschlossen: Der Import Ihrer Datei war erfolgreich.
  • Bereit. Ihre Datei hat die Validierung bestanden und kann importiert werden.
  • Ausstehend Die Verarbeitung Ihrer Datei wird unterbrochen, weil die Verarbeitung einer anderen Datei noch nicht abgeschlossen ist.
  • Laufen: Ihre Datei wird verarbeitet.
  • Validierung Ihre Datei befindet sich in der Validierungsphase.
  • Die Validierung ist fehlgeschlagen. Ihre Datei enthält einige Fehler. Beheben Sie die Fehler und versuchen Sie dann noch einmal, die Datei hochzuladen.
  • Fehlgeschlagen. Ihre Datei konnte nicht importiert werden.

Fehlerdetails ansehen

Wenn nach dem Importieren Ihrer Dateien Fehler auftreten, können Sie sich die Fehlermeldung direkt in der Google Cloud Console ansehen.

So prüfen Sie die Fehler Ihres Uploadjobs:

  1. Rufen Sie die Seite Datenimport auf und klicken Sie dann auf Dateiuploads.
  2. Klicken Sie auf die Importdatei, für die eine Warnung oder ein Fehler angezeigt wird. Auf der Detailseite der Importdatei wird die vollständige Liste der Fehler angezeigt.

Auf der Detailseite der Importdatei können Sie die Assets und Datenfelder prüfen, die zu den Fehlern führen, und eine Beschreibung des Fehlers aufrufen. Fehler beim Dateiimportjob können verhindern, dass im Migration Center neue Assets erstellt oder vorhandene mit den neuen Änderungen aktualisiert werden. Bearbeiten Sie die Dateien, um den Fehler zu beheben, und erstellen Sie einen neuen Dateiimportauftrag, um sie noch einmal hochzuladen.

Weitere Informationen zu den möglichen Fehlermeldungen finden Sie unter Fehlerbehebung bei Dateiimportfehlern.

Importdateianforderungen

In den folgenden Tabellen finden Sie die technischen Spezifikationen für die Vorlagendateien, die für den manuellen Import verwendet werden.

vmInfo-Datei

Spalte Erwarteter Typ Beschreibung
MachineId String Die eindeutige Kennung der virtuellen Maschine.
MachineName String Der Anzeigename der virtuellen Maschine.
PrimaryIPAddress String Die IP-Adresse des Computers.
PrimaryMACAddress String Die MAC-Adresse des Computers. Dieser Wert wird nur zur Identifizierung des Geräts verwendet.
PublicIPAddress String Die öffentliche IP-Adresse des Computers.
IpAddressListSemiColonDelimited Liste der Nachrichten Die Liste der zugewiesenen Netzwerkadressen.
TotalDiskAllocatedGiB int64 Die Gesamtkapazität des Laufwerks.
TotalDiskUsedGiB int64 Der Gesamtwert des verwendeten Speicherplatzes auf dem Laufwerk.
MachineTypeLabel String Das Label für den AWS- oder Azure-Maschinentyp.
AllocatedProcessorCoreCount int64 Anzahl der CPU-Kerne in der virtuellen Maschine.
MemoryGiB int32 Die Arbeitsspeicherkapazität der virtuellen Maschine.
HostingLocation String Der Standort des Geräts im AWS- oder Azure-Format.
OsType String Das Betriebssystem des Computers.
OsName String Das Betriebssystem des Computers.
OsVersion String Die Version des Betriebssystems des Computers.
MachineStatus String Der Betriebsstatus des Geräts.
ProvisioningState String Der Bereitstellungsstatus, nur für Azure-VMs.
CreateDate Zeitstempel Der Erstellungszeitstempel des Geräts.
IsPhysical String Ob es sich um eine physische oder virtuelle Maschine handelt.
Quelle Nachricht Die Details der Quelle für AWS- oder Azure-Maschinen.

diskInfo-Datei

Spalte Erwarteter Typ Beschreibung
MachineId String Die eindeutige Kennung der virtuellen Maschine.
DiskLabel String Das Laufwerkslabel.
SizeInGib int64 Die Gesamtkapazität des Laufwerks.
UsedInGib int64 Der Gesamtwert des verwendeten Speicherplatzes auf dem Laufwerk.
StorageTypeLabel String Der Laufwerklabeltyp (z. B. BIOS oder GPT).

perfInfo-Datei

Spalte Erwarteter Typ Beschreibung
MachineId String Die eindeutige Kennung der virtuellen Maschine.
TimeStamp Der Zeitstempel, zu dem die Stichprobe erhoben wurde.
CpuUtilizationPercentage float Der prozentuale Anteil der verwendeten CPU-Kapazität. Er muss im Intervall 0–100 liegen.
MemoryUtilizationPercentage float Der Prozentsatz des verwendeten Systemspeichers. Er muss im Intervall 0–100 liegen.
UtilizedMemoryBytes float Der insgesamt genutzte Arbeitsspeicher in Byte.
DiskReadOperationsPerSec float Die durchschnittlichen IOPS, die über einen kurzen Zeitraum erfasst wurden.
DiskWriteOperationsPerSec float Die durchschnittlichen IOPS, die über einen kurzen Zeitraum erfasst wurden.
NetworkBytesPerSecSent float Der durchschnittliche Netzwerkausgang in B/s, der über ein kurzes Zeitfenster erfasst wurde.
NetworkBytesPerSecReceived float Der durchschnittliche Netzwerkeintrag in B/s, der über einen kurzen Zeitraum erfasst wurde.

tagInfo-Datei

Spalte Erwarteter Typ Beschreibung
MachineId String Die eindeutige Kennung der virtuellen Maschine.
Schlüssel String Der Labelschlüssel.
Wert String Der Labelwert.

Parse-Algorithmus für Labels

Die Labels, die Sie mit der tagInfo-Datei hochladen, müssen den Anforderungen für Labels in Google Cloud entsprechen. Wenn das Label nicht den Anforderungen entspricht, wird es im Migration Center so konvertiert:

  1. Bei Schlüsseln werden alle vorangestellten Zeichen entfernt, die keine Buchstaben des englischen Alphabets sind.
  2. Er ersetzt alle Großbuchstaben durch Kleinbuchstaben.
  3. Alle ungültigen Zeichen werden durch Unterstriche (_) ersetzt.
  4. Das Label wird auf maximal 62 Zeichen gekürzt.
  5. Es wird das Suffix _<CRC32> hinzugefügt, das anhand des ursprünglichen Strings berechnet wird.

Jedes Mal, wenn ein Label konvertiert wird, wird eine Warnmeldung angezeigt.

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

Nächste Schritte