Im Migration Center können Sie Tabellen mit Daten hochladen, die Sie manuell mithilfe der bereitgestellten Vorlagen ausfüllen. Das ist nützlich, 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:
- Laden Sie die Vorlagen aus der Liste der verfügbaren Vorlagen herunter.
- Füllen Sie die Tabellen manuell mit den Daten aus Ihrer Infrastruktur aus.
- 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 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
Rufen Sie die Seite Datenimport auf.
Klicken Sie auf Daten hinzufügen > Dateien hochladen.
Geben Sie im Bereich Dateiupload einrichten den Namen des Dateiuploads ein.
Wählen Sie in der Liste Dateiformat die Option Manuell ausgefüllte CSV-Vorlagen aus.
Klicken Sie auf Dateien zum Hochladen auswählen und wählen Sie alle Dateien aus, die Sie hochladen möchten.
Klicken Sie auf Dateien hochladen, um den Upload zu bestätigen und zu starten.
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" }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.
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
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 DatendateiIMPORT_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
signedUrlder Antwort.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.
Optional: Wiederholen Sie die Schritte 3 bis 6, um weitere Datendateien im selben Importauftrag zu erstellen.
Optional: Alle Datendateien eines Importjobs abrufen.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles
Validieren Sie den Importjob.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
Rufen Sie den Importjob und den Validierungsbericht auf. Wenn der Status
READYlautet, 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 und den Ausführungsbericht auf. Wenn der Status
COMPLETEDlautet, 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 der 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 im 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:
- Rufen Sie die Seite Datenimport auf und klicken Sie dann auf Dateiuploads.
- Wählen Sie in der Liste der Dateiimporte den Upload aus, den Sie überprüfen möchten.
- 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 des Uploadjobs:
- Rufen Sie die Seite Datenimport auf und klicken Sie dann auf Dateiuploads.
- 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. Beheben Sie den Fehler, indem Sie die Dateien bearbeiten und einen neuen Dateiimportauftrag erstellen, 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 Energiestatus 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 Prozentsatz 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 verwendete 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 an Labels in Google Cloud entsprechen. Wenn das Label nicht den Anforderungen entspricht, wird es im Migration Center so konvertiert:
- Bei Schlüsseln werden alle vorangestellten Zeichen entfernt, die keine Buchstaben des englischen Alphabets sind.
- Er ersetzt alle Großbuchstaben durch Kleinbuchstaben.
- Alle ungültigen Zeichen werden durch Unterstriche (
_) ersetzt. - Das Label wird auf maximal 62 Zeichen gekürzt.
- 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
- Weitere Informationen zu den Erfassungsmethoden im Migrationscenter
- Weitere Informationen zum Verwalten von Dateiuploads