Todos los productos
Search

Este producto

    IoT Platform:Migración de instancias

    Centro de documentos

    IoT Platform:Migración de instancias

    Última actualización: Sep 08, 2026

    Migre los datos de una instancia pública heredada a una instancia Enterprise Edition de destino. Para ello, cree una tarea de migración, ejecute una migración por fases y, después, inicie la migración completa.

    Requisitos previos

    • Conozca el proceso general y las consideraciones para la migración de instancias. Para obtener más información, consulte Overall migration flow.

    • Complete la evaluación del negocio y las modificaciones del sistema. Para obtener más información, consulte Preparations before migration.

    Paso 1: Crear una tarea de migración

    Cree una tarea de migración para un producto específico en su instancia pública. El estado inicial de la tarea es To be Migrated, lo que indica que la migración no ha comenzado y no afectará sus servicios.

    1. Inicie sesión en la consola de IoT Platform.

    2. En la esquina superior izquierda de la consola, seleccione la región donde se activó IoT Platform. En la pestaña Instance Overview, haga clic en Public Instance.

      Importante

      La función de migración de instancias solo admite la migración de datos desde una instancia pública heredada hacia una instancia Standard Enterprise. Para obtener más información sobre las instancias, consulte Instance overview.

    3. En el panel de navegación izquierdo, elija Resource Allocation > Instance Migration. En la pestaña Migration List, haga clic en Create Migration Task.

    4. En el cuadro de diálogo, seleccione el Target Instance ID y el Product de la instancia pública que desea migrar. Después, haga clic en OK.

      Crear una tarea de migración no inicia el proceso. Antes de continuar, asegúrese de que la instancia de destino tenga suficiente cuota de dispositivos para el producto seleccionado y revise la documentación de migración.

      Una vez creada la tarea de migración, su estado será To be Migrated, lo que indica que la migración aún no ha comenzado.

    5. Optional: View migration details: En la página Migration Details, consulte la información de la tarea de migración.

    6. Optional: Enable data synchronization: La sincronización de datos del modelo TSL del dispositivo está deshabilitada de forma predeterminada. Puede habilitarla inmediatamente después de crear la tarea de migración para evitar interrupciones del servicio durante el proceso.

      Nota

      Si su negocio no requiere la sincronización de datos de dispositivos, omita este paso.

    Paso 2: Migración por fases

    Ejecute primero una migración por fases con un lote pequeño de dispositivos. Supervise el proceso para comprobar que sus servicios no se vean afectados antes de iniciar la migración completa.

    Importante

    • Se recomienda crear nuevos dispositivos dentro del producto para la migración por fases.

    • Si configuró una suscripción del lado del servidor AMQP o el reenvío de mensajes a AMQP, debe copiar el ID del grupo de consumidores actualizado y reiniciar el SDK del cliente AMQP para recibir datos una vez que finalice la migración por fases.

    Inicio de la migración por fases

    1. En la pestaña Migration List, busque la tarea con estado To be Migrated y haga clic en Start Migration en la columna Actions.

    2. En el cuadro de diálogo Start Migration Task, seleccione un método para especificar los dispositivos de la migración por fases.

      Importante

      La cantidad de dispositivos por migrar no puede superar la cuota restante de dispositivos de la instancia de destino. De lo contrario, el sistema mostrará el mensaje de error: The total number of devices in the target instance exceeds the maximum limit.

      Selección manual

      Importante

      Con este método, puede seleccionar hasta 100 dispositivos por cada tarea de migración por fases.

      1. Haga clic en la lista desplegable de dispositivos canary. En el panel de dispositivos que aparece a la derecha, active las casillas de verificación junto a los dispositivos deseados.

      2. Haga clic en OK.

      Cargar archivo

      Importante

      Con este método, puede agregar hasta 10 000 dispositivos por cada tarea de migración por fases.

      1. Haga clic en Download Template. En el archivo descargado, introduzca los nombres de los dispositivos en la columna DeviceNames y guarde el archivo.

      2. Haga clic en Upload File para cargar el archivo guardado en la consola de IoT Platform.

    3. Confirme que completó todas las operaciones previas a la migración, active las casillas correspondientes y haga clic en Start Now.

      Las tres casillas de verificación son I have read the migration documentation, Server-side modifications are complete y I have verified the process with test devices.

    Lanzamiento canary en curso

    En la pestaña Migration List, el estado de la tarea de migración cambia a Canary release in progress.

    Durante esta etapa, solo puede consultar los detalles de la migración. Haga clic en View en la columna Actions para abrir la página Migration Details y consultar la información de la tarea. Para obtener más información, consulte Optional: View migration details.

    Lanzamiento canary completado

    Cuando la tarea de migración entra en el estado Canary Release Completed, los dispositivos especificados ya se migraron. Puede continuar con la migración completa o revertir la migración si es necesario. Para obtener más información, consulte los siguientes temas:

    Paso 3: Migración completa

    Una vez finalizada la migración por fases, inicie la migración completa del producto especificado.

    Importante

    Asegúrese de que la refactorización del sistema esté terminada y publicada. Por ejemplo, las llamadas a la API de la nube deben incluir el ID de la instancia Enterprise y el ID del grupo de consumidores en el SDK del cliente AMQP debe estar actualizado. Para obtener más información, consulte Preparations before migration.

    Inicio de la migración completa

    1. En la pestaña Migration List, busque la tarea con estado Canary Release Completed y haga clic en Start Migration en la columna Actions.

    2. En el cuadro de diálogo Start Migration Task, haga clic en Full Migration. Confirme que completó todas las operaciones previas a la migración, active las casillas correspondientes y haga clic en Start Now.

      Importante

      La cantidad de dispositivos por migrar no puede superar la cuota restante de dispositivos de la instancia de destino. De lo contrario, el sistema mostrará el mensaje de error: The total number of devices in the target instance exceeds the maximum limit.

      Las tres casillas de verificación son I have read the migration documentation, Server-side modifications are complete y I have verified the process with test devices.

    Migración en curso

    En la pestaña Migration List, el estado de la tarea de migración cambia a Migrating.

    Durante esta etapa, puede consultar los detalles, pausar la tarea o revertirla:

    Migración completada

    Cuando el estado de la tarea de migración cambia a Migration Completed, el producto especificado y sus dispositivos ya se migraron desde la instancia pública. Si también finalizó la migración de los datos reportados por los dispositivos, puede deshabilitar manualmente la sincronización de datos. Para obtener más información, consulte Optional: Disable data synchronization.

    Opcional: Revertir una tarea de migración

    Importante

    • No es posible revertir una tarea que se encuentre en el estado Canary release in progress.

    • Antes de iniciar una reversa, asegúrese de que el producto correspondiente no se haya eliminado de la instancia pública. Si el producto se eliminó, la reversa fallará.

    • La reversa no elimina de la instancia Enterprise Edition de destino los datos de suscripción del lado del servidor ni del motor de reglas que ya se migraron.

    Inicio de la reversa

    Según los requisitos de su negocio, puede revertir tareas de migración que se encuentren en los estados Canary Release Completed, Migrating, Pause Migration, Continue Migration o Migration Completed:

    1. En la pestaña Migration List, haga clic en Rollback en la columna Actions de la tarea de migración.

    2. En el cuadro de diálogo Start Rollback Task, seleccione un tipo de reversa para deshacer la migración de dispositivos.

      Dispositivos específicos

      Elija uno de los siguientes métodos para seleccionar los dispositivos que desea revertir y haga clic en Start Now.

      Importante

      Con este método, puede seleccionar hasta 10 000 dispositivos por cada tarea de reversa.

      Selección manual

      1. Haga clic en la lista desplegable de dispositivos de reversa. En el panel de dispositivos que aparece a la derecha, active las casillas de verificación junto a los dispositivos deseados.

      2. Haga clic en OK.

      En el cuadro de diálogo Start Rollback Task, establezca Rollback Type en Specific Devices y Device Selection Method en Manual Selection. Después de seleccionar los dispositivos, haga clic en Start Now.

      Cargar archivo

      1. Haga clic en Download Template. En el archivo descargado, introduzca los nombres de los dispositivos en la columna DeviceNames y guarde el archivo.

      2. Haga clic en Upload File para cargar el archivo guardado en la consola de IoT Platform.

      En el cuadro de diálogo Start Rollback Task, establezca Rollback Type en Specific Devices y Device Selection Method en Upload File. Después, haga clic en Start Now.

    Reversa en curso

    • Para las tareas en estado Canary Release Completed, Migrating, Pause Migration o Continue Migration, iniciar una reversa cambia su estado a Rolling Back. Puede pausar una tarea que se encuentre en este estado. Para obtener más información, consulte Optional: Pause a migration task.

    • Para una tarea en estado Migration Completed, iniciar una reversa cambia su estado a Batch Rollback. No es posible pausar una tarea en este estado.

    Reversa completada

    Una vez finalizada la reversa, todos los datos de dispositivos migrados de la tarea quedan invalidados y el estado de la tarea de migración vuelve a To be Migrated.

    Importante

    Después de una reversa exitosa, si necesita volver a migrar los datos del producto:

    Opcional: Pausar una tarea de migración

    Puede pausar una tarea de migración que se encuentre en el estado Migrating o Rolling Back. En la pestaña Migration List, haga clic en Pause en la columna Actions de la tarea de migración y, después, haga clic en Confirm.

    El resultado de esta operación depende del estado anterior de la tarea:

    Estado anterior

    Resultado

    Migrating

    El estado de la tarea cambia a Pause Migration y los datos del producto dejan de migrarse a la instancia de destino.

    Puede hacer clic en Continue Migration para reanudar la tarea de migración completa.

    Rolling Back

    El estado de la tarea cambia a Pause Rollback.

    Puede hacer clic en Continue Rollback para completar la reversa de la tarea de migración.

    Haga clic en Start Now.

    En el cuadro de diálogo Start Rollback Task, establezca Rollback Type en Specific Devices o All Devices. Una reversa completa devuelve todos los dispositivos migrados de la tarea a la instancia pública.

    Opcional: Consultar los detalles de la migración

    1. En la pestaña Migration List, haga clic en View en la columna Actions de la tarea de migración.

    2. En la página Migration Details, consulte la información de la tarea, como ProductKey, estado de la migración, cantidad total de dispositivos, ID de la instancia de destino, hora de creación, hora de inicio de la sincronización de datos y la lista de dispositivos seleccionados para la migración.

      Puede filtrar los dispositivos por estado de migración (Not Migrated, Migrated o Migration Failed) o buscar un dispositivo específico para revisar su progreso de migración.

      Si un dispositivo presenta errores al migrarse, .

      La parte superior de la página Migration Details muestra el estado de la tarea como Canary release in progress.

    3. Opcional: Regrese a la página Instance Migration y haga clic en Migration Monitoring para consultar las estadísticas en tiempo real de las métricas de datos de migración. Para obtener más información, consulte View migration data metrics.

      Las métricas de monitoreo de la migración incluyen Online Device Count y Message Volume Sent to Platform. Puede usar la lista desplegable Time para filtrar las estadísticas por intervalo de tiempo.

    Opcional: Habilitar la sincronización de datos

    La sincronización de datos del modelo TSL del dispositivo está deshabilitada de forma predeterminada. Puede habilitarla después de crear una tarea de migración para evitar interrupciones del servicio durante el proceso.

    1. En la pestaña Migration List, haga clic en View en la columna Actions de la tarea de migración.

    2. En la esquina superior derecha de la página Migration Details, haga clic en Enable Data Synchronization.

      En este punto, la página muestra "-" tanto en Data Migration Status como en Data Synchronization Start Time, lo que indica que la sincronización de datos no está habilitada.

      Una vez habilitada la sincronización de datos, la información que reporten los dispositivos del producto especificado en la instancia pública se sincronizará con la instancia Enterprise Edition de destino. La sincronización comienza en menos de un minuto después de habilitarla.

      En la página Migration Details, puede consultar la Data Synchronization Start Time específica y el Data Migration Status.

    Opcional: Deshabilitar la sincronización de datos

    El sistema deshabilita automáticamente la sincronización de datos 30 días después de habilitarla. También puede deshabilitarla de forma manual:

    Nota

    Antes de deshabilitar la sincronización de datos, asegúrese de que la migración de la instancia haya terminado para evitar interrupciones del servicio.

    1. En la pestaña Migration List, haga clic en View en la columna Actions de la tarea de migración.

    2. En la esquina superior derecha de la página Migration Details, haga clic en Disable Data Synchronization.

      Importante

      Si deshabilita manualmente la sincronización de datos, no podrá volver a habilitarla cuando la tarea de migración haya terminado. Si la tarea aún no termina, sí podrá habilitarla de nuevo.

    Resultados

    Cuando el estado de la tarea cambia a Migration Completed, los datos del producto ya se migraron a la instancia de destino.