Migration Center te permite subir tablas de datos que completas manualmente con las plantillas proporcionadas. Esto es útil si tu infraestructura tiene una cantidad limitada de recursos y deseas crear los datos de forma manual.
Para importar las tablas que completaste de forma manual, sigue estos pasos:
- Descarga las plantillas de la lista de plantillas disponibles.
- Completa las tablas de forma manual con los datos de tu infraestructura.
- Sube las tablas al Centro de migraciones.
Limitaciones
- El tamaño máximo para subir un archivo es de 100 MB.
Plantillas de datos disponibles
En la siguiente tabla, se proporcionan las plantillas de archivos que puedes usar para subir tus datos de infraestructura a Migration Center. Las plantillas contienen datos de muestra como sugerencia para completar la tabla. Para obtener una descripción detallada del formato de datos requerido, consulta Especificaciones de los archivos de importación.
| Nombre del archivo | Tipo de datos | Descripción |
|---|---|---|
| vmInfo.csv | Información de la máquina | Usa esta plantilla para proporcionar información sobre recursos individuales, incluidos CPU, memoria y otros parámetros de configuración. Esta tabla es obligatoria cada vez que creas una importación nueva. |
| perfInfo.csv | Datos de rendimiento | Opcional: Usa esta plantilla para proporcionar datos de rendimiento para tus recursos en un formato de serie temporal. |
| diskInfo.csv | Datos del disco | Opcional: Usa esta plantilla para proporcionar información sobre los discos y su uso. |
| tagInfo.csv | Etiquetas del sistema | Opcional: Usa esta plantilla para asignar etiquetas a los activos. Las etiquetas deben cumplir con los requisitos para las etiquetas en Google Cloud. |
Para obtener más información sobre las especificaciones de cada archivo, consulta Especificaciones de los archivos de importación.
Sube las tablas
Para subir los archivos, sigue estos pasos:
Console
Ve a la página Importación de datos.
Haz clic en Agregar datos > Subir archivos.
En la sección Configurar carga de archivos, ingresa el nombre de la carga de archivos.
En la lista Formato de archivo, selecciona Plantillas de CSV propagadas manualmente.
Haz clic en Seleccionar archivos para subir y, luego, selecciona todos los archivos que desees subir.
Para confirmar y comenzar a subir los archivos, haz clic en Subir archivos.
Si los archivos se validan correctamente, para crear los recursos a partir de ellos, haz clic en Importar datos y, luego, en Confirmar.
API
Crea un trabajo de importación.
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" }Reemplaza lo siguiente:
PROJECT_ID: Es el ID del proyecto en el que se creará el trabajo de importación.REGION: Es la región en la que se creará el trabajo de importación.IMPORT_JOB_ID: Es el ID del nuevo trabajo de importación.SOURCE_ID: Es el ID de una fuente existente que se asociará con el trabajo de importación.
Opcional: Para confirmar que el trabajo de importación se creó correctamente, obtén el trabajo de importación.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Crea un archivo de datos de importación adjunto al trabajo de importación.
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" }Reemplaza lo siguiente:
DATA_FILE_ID: Es el ID del nuevo archivo de datos.IMPORT_JOB_FORMAT:IMPORT_JOB_FORMAT_MANUAL_CSV
Obtén el archivo de datos.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID
Copia la URL del campo
signedUrlde la respuesta.Sube un archivo a la URL copiada.
PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
Reemplaza lo siguiente:
UPLOAD_FILE_PATH: Es la ruta de acceso local del archivo que se sube.COPIED_URL: La URL firmada copiada de los pasos de vista previa.
Opcional: Repite los pasos del 3 al 6 para crear más archivos de datos en la misma tarea de importación.
Opcional: Obtén todos los archivos de datos de un trabajo de importación.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles
Valida el trabajo de importación.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
Obtén el trabajo de importación y consulta el informe de validación. Si el estado es
READY, puedes continuar con los pasos siguientes. De lo contrario, debes corregir el trabajo o los archivos específicos. Esto podría requerir que borres archivos o subas otros nuevos.GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Ejecuta el trabajo de importación.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run
Obtén el trabajo de importación y consulta el informe de ejecución. Si el estado es
COMPLETED, el trabajo se ejecutó correctamente. De lo contrario, si el trabajo falló y está en un estado terminal, el informe de ejecución incluye los errores. Crea un trabajo de importación nuevo y aplica los cambios necesarios.GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Si tienes problemas con la carga de archivos, consulta cómo solucionar problemas relacionados con mensajes de error comunes.
Revisa la carga
Después de subir tus archivos, el Centro de migraciones los valida para verificar si son correctos de forma formal. Si la validación se realiza correctamente, Migration Center procesará los datos para crear recursos nuevos o actualizar los existentes. Puedes verificar el estado de tus trabajos de carga desde la consola de Google Cloud.
Para revisar el estado de tu trabajo de carga, sigue estos pasos:
- Ve a la página Importación de datos y, luego, haz clic en Subidas de archivos.
- En la lista de importaciones de archivos, selecciona la carga que quieres revisar.
- En la página de carga de archivos, en Progreso de la importación de datos, revisa el Estado de los archivos que subiste.
Puedes ver tus archivos con uno de los siguientes estados.
Lista de estados
- Completada. Se importó correctamente tu archivo.
- Listo. Tu archivo pasó la validación y está listo para importarse.
- Pendiente. Tu archivo está esperando a que se termine de procesar otro.
- Correr. Se está procesando tu archivo.
- Validación: Tu archivo está en la etapa de validación.
- Error de validación. Tu archivo contiene algunos errores. Corrige los errores y, luego, intenta subir el archivo nuevamente.
- Fallida. No se pudo importar tu archivo.
Revisa los detalles del error
Si encuentras errores después de importar tus archivos, puedes revisar el mensaje de error directamente en la consola de Google Cloud.
Para revisar los errores de tu trabajo de carga, sigue estos pasos:
- Ve a la página Importación de datos y, luego, haz clic en Subidas de archivos.
- Haz clic en el archivo de importación que muestra una advertencia o un error. La página de detalles del archivo de importación muestra la lista completa de errores.
En la página de detalles del archivo de importación, puedes revisar los activos y los campos de datos que causan los errores, así como ver una descripción del error. Los errores en el trabajo de importación de archivos pueden impedir que Migration Center cree recursos nuevos o actualice los existentes con los cambios nuevos. Para corregir el error, edita los archivos y crea un nuevo trabajo de importación de archivos para subirlos nuevamente.
Para obtener más información sobre los posibles mensajes de error, consulta Soluciona problemas de importación de archivos.
Especificaciones de los archivos de importación
En las siguientes tablas, se muestran las especificaciones técnicas de los archivos de plantillas que se usan para la importación manual.
Archivo vmInfo
| Columna | Tipo esperado | Descripción |
|---|---|---|
| MachineId | string | Es el identificador único de la máquina virtual. |
| MachineName | string | El nombre visible de la máquina virtual. |
| PrimaryIPAddress | string | Es la dirección IP de la máquina. |
| PrimaryMACAddress | string | La dirección MAC de la máquina Esto solo se usa para identificar la máquina. |
| PublicIPAddress | string | La dirección IP pública de la máquina |
| IpAddressListSemiColonDelimited | Lista de mensajes | Es la lista de direcciones de red asignadas o asignadas. |
| TotalDiskAllocatedGiB | int64 | Es la capacidad total del disco. |
| TotalDiskUsedGiB | int64 | Es la cantidad total de espacio usado en el disco. |
| MachineTypeLabel | string | La etiqueta del tipo de máquina de AWS o Azure. |
| AllocatedProcessorCoreCount | int64 | Cantidad de núcleos de CPU en la máquina virtual. |
| MemoryGiB | int32 | Es la cantidad de memoria de la máquina virtual. |
| HostingLocation | string | Es la ubicación de la máquina en formato AWS o Azure. |
| OsType | string | Es el SO de la máquina. |
| OsName | string | Es el SO de la máquina. |
| OsVersion | string | Es la versión del SO de la máquina. |
| MachineStatus | string | Es el estado de la alimentación de la máquina. |
| ProvisioningState | string | El estado de aprovisionamiento, solo para VMs de Azure. |
| CreateDate | Marca de tiempo | La marca de tiempo de creación de la máquina. |
| IsPhysical | string | Si la máquina es física o máquina virtual. |
| Fuente | mensaje | Los detalles de la fuente para las máquinas de AWS o Azure |
Archivo diskInfo
| Columna | Tipo esperado | Descripción |
|---|---|---|
| MachineId | string | Es el identificador único de la máquina virtual. |
| DiskLabel | string | La etiqueta del disco. |
| SizeInGib | int64 | Es la capacidad total del disco. |
| UsedInGib | int64 | Es la cantidad total de espacio usado en el disco. |
| StorageTypeLabel | string | Es el tipo de etiqueta de disco (por ejemplo, BIOS o GPT). |
Archivo perfInfo
| Columna | Tipo esperado | Descripción |
|---|---|---|
| MachineId | string | Es el identificador único de la máquina virtual. |
| TimeStamp | Es la marca de tiempo del momento en que se recopiló la muestra. | |
| CpuUtilizationPercentage | float | Es el porcentaje de la capacidad total de la CPU que se usa. Debe estar entre 0 y 100. |
| MemoryUtilizationPercentage | float | Es el porcentaje de memoria del sistema que se usa. Debe estar entre 0 y 100. |
| UtilizedMemoryBytes | float | Es la memoria total usada en bytes. |
| DiskReadOperationsPerSec | float | Es el promedio de IOPS muestreados en un período breve. |
| DiskWriteOperationsPerSec | float | Es el promedio de IOPS muestreados en un período breve. |
| NetworkBytesPerSecSent | float | Es la salida de red promedio en B/s, muestreada en un período breve. |
| NetworkBytesPerSecReceived | float | Es la entrada de red promedio en B/s, muestreada en un período breve. |
Archivo tagInfo
| Columna | Tipo esperado | Descripción |
|---|---|---|
| MachineId | string | Es el identificador único de la máquina virtual. |
| Clave | string | Es la clave de etiqueta. |
| Valor | string | El valor de la etiqueta. |
Algoritmo de análisis de etiquetas
Las etiquetas que subas con el archivo tagInfo deben cumplir con los requisitos de las etiquetas en Google Cloud. Si la etiqueta no cumple con los requisitos, el Centro de migraciones usa la siguiente estrategia para convertirla:
- Solo para las claves, quita todos los caracteres iniciales que no sean letras del alfabeto inglés.
- Reemplaza todas las letras mayúsculas por minúsculas.
- Reemplaza todos los caracteres no válidos por guiones bajos (
_). - Trunca la etiqueta a un máximo de 62 caracteres.
- Agrega el sufijo
_<CRC32>, que se calcula en función de la cadena original.
Aparecerá un mensaje de advertencia cada vez que se convierta una etiqueta.
Si la validación falla o si la clave ya existe, la importación omite la fila y aparece un mensaje de advertencia.
¿Qué sigue?
- Obtén más información sobre los métodos de recopilación de Migration Center.
- Obtén más información para administrar las cargas de archivos.