Importa tablas generadas manualmente

El Centro de migraciones te permite subir tablas de datos que debes completar 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:

  1. Descarga las plantillas de la lista de plantillas disponibles.
  2. Completa las tablas de forma manual con los datos de tu infraestructura.
  3. Sube las tablas al Centro de migraciones.

Limitaciones

  • El tamaño máximo de carga de 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 brindar información sobre recursos individuales, incluidos la CPU, la 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. Etiquetas debe 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

  1. Ve a la página Importación de datos.

    Ir a Importación de datos

  2. Haz clic en Agregar datos > Subir archivos.

  3. En la sección Configurar carga de archivos, ingresa el nombre de la carga de archivos.

  4. En la lista Formato de archivo, selecciona Plantillas de CSV propagadas manualmente.

  5. Haz clic en Seleccionar archivos para subir y, luego, selecciona todos los archivos que desees subir.

  6. Para confirmar y comenzar a subir los archivos, haz clic en Subir archivos.

  7. Si los archivos se validan correctamente, para crear los recursos a partir de ellos, haz clic en Importar datos y, luego, en Confirmar.

API

  1. 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 para crear la un trabajo de importación.
    • REGION: Es la región en la que se creará el trabajo de importación.
    • IMPORT_JOB_ID: El ID del trabajo de importación nuevo.
    • SOURCE_ID: Es el ID de una fuente existente que se asociará con el trabajo de importación.
  2. Opcional: Para confirmar que el trabajo de importación se creó correctamente, obtener el trabajo de importación.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
    
  3. 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
  4. 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
    
  5. Copia la URL del campo signedUrl de la respuesta.

  6. 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 que se suba.
    • COPIED_URL: La URL firmada copiada de los pasos de vista previa.
  7. Opcional: Repite los pasos del 3 al 6 para crear más archivos de datos en la misma tarea de importación.

  8. 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
    
  9. Valida el trabajo de importación.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
    
  10. Obtén el trabajo de importación y consulta el informe de validación. Si el estado es READY, es posible continuar con los pasos siguientes. De lo contrario, debes corregir el trabajo o archivos específicos. Esto puede requerir borrar archivos o subir otros nuevos.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
    
  11. Ejecuta el trabajo de importación.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run
    
  12. Obtén el trabajo de importación y consulta el informe de ejecución. Si el estado es COMPLETED, el trabajo se ejecutó de forma correcta. De lo contrario, si el trabajo falló y en 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 al subir el archivo, consulta cómo Solucionar problemas de 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. Verifica el estado de los trabajos de carga desde la consola de Google Cloud.

Para revisar el estado de tu trabajo de carga, sigue estos pasos:

  1. Ve a la página Importación de datos y, luego, haz clic en Cargas de archivos.
  2. En la lista de importaciones de archivos, selecciona la carga que deseas revisar.
  3. En la página de carga de archivos, en Progreso de la importación de datos, revisa el Estado de los archivos que subiste.

Tus archivos pueden tener uno de los siguientes estados.

Lista de estados

  • Completado. Se importó correctamente el 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.
  • En ejecución. Se está procesando tu archivo.
  • Validación: Tu archivo está en la etapa de validación.
  • Validación con errores. Tu archivo contiene algunos errores. Corrige los errores y, luego, intenta subir el archivo nuevamente.
  • Fallida. No se pudo importar el archivo.

Revisa los detalles del error

Si encuentras errores después de importar los 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:

  1. Ve a la página Importación de datos y, luego, haz clic en Subidas de archivos.
  2. 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 del archivo podrían impedir que el Centro de migraciones haga lo siguiente: crear nuevos recursos o actualizar los existentes con los nuevos cambios. Para corregir el error, edita tus archivos y crea un nuevo trabajo de importación de archivos para subirlos de nuevo.

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 plantilla 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 La dirección IP de la máquina.
PrimaryMACAddress string La dirección MAC de la máquina Esto solo se usa para identificar 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 La capacidad total del disco.
TotalDiskUsedGiB int64 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 La cantidad de memoria de la máquina virtual.
HostingLocation string 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 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 las 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 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 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 El porcentaje de memoria del sistema usado. 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 La salida de red promedio en B/s, muestreada en un período corto.
NetworkBytesPerSecReceived float La entrada de red promedio en B/s, muestreada en un período corto.

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 Es 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:

  1. Solo para las claves, se quitan todos los caracteres iniciales que no son letras del alfabeto inglés.
  2. Reemplaza todas las letras mayúsculas por minúsculas.
  3. Reemplaza todos los caracteres no válidos por guiones bajos (_).
  4. Trunca la etiqueta a un máximo de 62 caracteres.
  5. Agrega el sufijo _<CRC32>, calculado en función de la cadena original.

Cada vez que se convierte una etiqueta aparece un mensaje de advertencia.

Si la validación falla o si la clave ya existe, la importación omite la fila. y aparecerá un mensaje de advertencia.

¿Qué sigue?