Importa tablas generadas manualmente

El Centro de migraciones te permite subir tablas de datos que debes completar de forma manual con las plantillas proporcionadas. Esto es útil si la infraestructura tiene una cantidad limitada de elementos 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 a Migration Center.

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 archivo que puedes usar para subir los datos de tu infraestructura a Migration Center. Las plantillas contienen datos de muestra como sugerencias sobre cómo 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, como la CPU, la memoria y otros parámetros de configuración. Se requerirá esta tabla cada vez que crees una importación nueva.
perfInfo.csv Datos de rendimiento Opcional: Usa esta plantilla para proporcionar los datos de rendimiento de tus elementos en un formato de serie temporal.
diskInfo.csv Datos del disco Usa esta plantilla para proporcionar información sobre los discos y su uso (opcional).
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

  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 la carga del archivo, ingresa el nombre de la carga del archivo.

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

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

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

  7. Si los archivos se validaron de forma correcta, para crear los elementos a partir de los archivos, 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 el trabajo de importación.
    • REGION: 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: 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ó de forma correcta, obtén 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: ID del archivo de datos nuevo
    • 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 archivo que se sube.
    • COPIED_URL: Es la URL firmada copiada de los pasos de la vista previa.

  7. Opcional: Repite los pasos del 3 al 6 para crear más archivos de datos en el mismo trabajo de importación.

  8. Obtén todos los archivos de datos de un trabajo de importación (opcional).

    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 mira 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, lo que podría requerir borrar archivos o subir archivos 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 visualiza 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 nuevo trabajo de importación y aplica los cambios necesarios.

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

Si tienes problemas cuando subes un archivo, consulta cómo solucionar problemas de mensajes de error comunes.

Revisa la carga

Después de que subes los archivos, el Centro de migraciones los valida para verificar si son formalmente correctos. Si la validación se realiza de forma correcta, el Centro de migraciones procesa los datos para crear recursos nuevos o actualizar los existentes. Puedes comprobar el estado de tus trabajos de carga en 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 subidos.

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 que termine de procesarse otro archivo.
  • En ejecución. Se está procesando tu archivo.
  • Validación. Tu archivo está en la etapa de validación.
  • Validación con errores. Su archivo contiene algunos errores. Corrige los errores y, luego, intenta volver a subir el archivo.
  • Fallida. No se pudo importar el archivo.

Revisar 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 Cargas 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 elementos y los campos de datos que causan los errores y 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 tus archivos y crea un trabajo de importación de archivos nuevo a fin de subirlos de nuevo.

Para obtener más información sobre los posibles mensajes de error, consulta Soluciona errores 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 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 La dirección IP de la máquina.
PrimaryMACAddress string La dirección MAC de la máquina. Solo se usa para identificar la máquina.
PublicIPAddress string La dirección IP pública de la máquina.
IpAddressListSemiColonDelimited Lista de mensajes 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 El SO de la máquina.
OsName string El SO de la máquina.
OsVersion string La versión del SO de la máquina.
MachineStatus string El estado de energía 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 se trata de una máquina virtual o física.
Origen mensaje Son los detalles del origen de 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 La capacidad total del disco.
UsedInGib int64 La cantidad total de espacio usado en el disco.
StorageTypeLabel string Es el tipo de etiqueta del 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 La marca de tiempo en la que se recopiló la muestra.
CpuUtilizationPercentage float El porcentaje de la capacidad total de CPU usada. Debe estar en el intervalo 0-100.
MemoryUtilizationPercentage float El porcentaje de memoria del sistema usado. Debe estar en el intervalo 0-100.
UtilizedMemoryBytes float La memoria total usada en bytes.
DiskReadOperationsPerSec float Las IOPS promedio de las muestras durante un período corto.
DiskWriteOperationsPerSec float Las IOPS promedio de las muestras durante un período corto.
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 La clave de etiqueta.
Valor string Es el valor de la etiqueta.

Algoritmo de análisis de etiquetas

Las etiquetas que subes con el archivo tagInfo deben cumplir con los requisitos para 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 teclas, quita 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 aparece un mensaje de advertencia.

¿Qué sigue?