Manuell generierte Tabellen importieren

Im Migrationscenter können Sie Tabellen mit Daten hochladen, die Sie manuell mithilfe der bereitgestellten Vorlagen ausfüllen. Dies ist nützlich, wenn Ihre Infrastruktur 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.
  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 Laufwerksdaten Optional: Verwenden Sie diese Vorlage, um Informationen über Laufwerke und deren Auslastung.
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.

    Zur Seite „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 mit dem Hochladen zu beginnen.

  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, das erstellt werden soll und importieren.
    • REGION: Region zum Erstellen des Importjobs.
    • 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 aus der Antwort.

  6. Laden Sie eine Datei unter 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 des die hochgeladen wird.
    • COPIED_URL: Die kopierte signierte URL aus die Vorschauschritte an.
  7. Optional: Wiederholen Sie die Schritte 3 bis 6, um weitere Datendateien unter demselben und importieren.

  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, dies das Löschen von Dateien oder das Hochladen neuer Dateien.

    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 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 Endzustand befindet, wird der Ausführungsbericht enthält die Fehler. Erstellen Sie einen neuen Importjob und übernehmen Sie die erforderlichen Änderungen.

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

Wenn Sie Probleme mit dem Datei-Upload haben, lesen Sie nach, wie Sie Häufige Fehlermeldungen beheben

Upload überprü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 über die Google Cloud Console.

So prüfen Sie den Status Ihres Uploadjobs:

  1. Rufen Sie die Seite Datenimport auf und klicken Sie 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 jetzt importiert werden.
  • Ausstehend Ihre Datei wartet, bis eine andere Datei verarbeitet wurde.
  • Läuft: Ihre Datei wird verarbeitet.
  • Wird validiert. Ihre Datei befindet sich in der Validierungsphase.
  • Die Validierung ist fehlgeschlagen. Die Datei enthält Fehler. Beheben Sie die Fehler und versuchen Sie dann noch einmal, die Datei hochzuladen.
  • Fehlgeschlagen. Die Datei konnte nicht importiert werden.

Fehlerdetails ansehen

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

So prüfen Sie die Fehler des Uploadjobs:

  1. Rufen Sie die Seite Datenimport auf und klicken Sie 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 im Dateiimportjob verhindern möglicherweise, dass das Migration Center neue Assets zu erstellen oder vorhandene Assets mit den neuen Änderungen zu aktualisieren. Um den Fehler zu beheben, bearbeiten Sie Ihre Dateien und erstellen Sie einen neuen Dateiimportjob zum Hochladen noch einmal.

Weitere Informationen zu den möglichen Fehlermeldungen finden Sie unter Fehler beim Dateiimport beheben

Spezifikationen für Importdateien

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 wird nur zur Identifizierung der Maschine.
PublicIPAddress String Die öffentliche IP-Adresse des Computers.
IpAddressListSemiColonDelimited Liste der Nachrichten Die Liste der zugewiesenen oder zugewiesenen Netzwerkadressen.
TotalDiskAllocatedGiB int64 Die Gesamtkapazität des Laufwerks.
TotalDiskUsedGiB int64 Der insgesamt genutzte Speicherplatz auf dem Laufwerk.
MachineTypeLabel String Das Label des AWS- oder Azure-Maschinentyps.
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 der Maschine.
OsVersion String Die Version des Betriebssystems des Computers.
MachineStatus String Der Stromversorgungsstatus der Maschine.
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 insgesamt genutzte Speicherplatz 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 Prozentsatz der insgesamt genutzten CPU-Kapazität. Er muss im Intervall 0–100 liegen.
MemoryUtilizationPercentage float Der Prozentsatz des verwendeten Systemspeichers. Er muss im Intervall liegen 0–100.
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 ein kurzes Fenster 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, verwendet das Migration Center verwenden Sie die folgende Strategie, um das Label zu konvertieren:

  1. Nur bei Schlüsseln werden alle führenden Zeichen entfernt, die keine Buchstaben sind des englischen Alphabets.
  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.

Bei jeder Umwandlung eines Labels 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 wird angezeigt.

Nächste Schritte