IoT Platform:Consulta del estado de actualización

Requisitos previos

Debe haber creado una tarea de actualización por lotes para sus dispositivos. Para obtener más información, consulte

Create a batch update task

.

Procedimiento

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

2. En la página Overview, localice la instancia que desea gestionar y haga clic en el ID o el nombre de la instancia.

3. En el panel de navegación izquierdo, seleccione Maintenance > OTA Update.

   Nota

   Para ofrecer un mejor servicio, IoT Platform ha mejorado la función de actualización OTA e incorporó estadísticas sobre las versiones de los paquetes de actualización. La primera vez que utilice la nueva función de actualización OTA en la consola, deberá asociar los paquetes de actualización cargados con productos. Cada paquete de actualización solo se puede asociar con un producto. Para obtener más información sobre cómo asociar paquetes de actualización con productos, consulte las instrucciones en la consola.

4. En la lista de paquetes de actualización, localice el paquete destino, haga clic en View en la columna Actions y luego seleccione una de las siguientes pestañas:

   • Batch management

     • Consulte los tipos de lotes de actualización, como Verify update package y Batch update.

     • Haga clic en View en la columna Actions del lote de actualización destino. En la página Batch details, haga clic en la pestaña Device list para ver los dispositivos de este lote, agrupados por su estado de actualización.Edit tagOK

       Estado	Descripción
       Pending Confirmation	La actualización OTA está en espera de confirmación en la aplicación móvil. Este estado aplica únicamente si configuró App confirm upgrade en Yes al crear la tarea de actualización por lotes.
       To Be Pushed	El sistema aún no ha enviado la notificación de actualización OTA al dispositivo. Este estado puede presentarse cuando el dispositivo está sin conexión, la actualización está programada o hay limitación de velocidad activa. El estado específico se muestra como: To Be Pushed (Device Offline) To Be Pushed (Scheduled: YYYY/MM/DD hh:mm:ss) To Be Pushed
       Pushed	Se envió la notificación de actualización OTA al dispositivo, pero este aún no ha reportado su progreso.
       Upgrading	El dispositivo recibió la notificación de actualización y comenzó a reportar su progreso.
       Updated	El dispositivo completó correctamente la actualización y reportó el nuevo número de versión. Nota Una vez finalizada la actualización, el dispositivo debe reportar inmediatamente el nuevo número de versión. De lo contrario, la actualización puede agotar el tiempo de espera y marcarse con errores.
       update failed	Una actualización puede fallar por varios motivos: Inicia una nueva tarea de actualización por lotes para un dispositivo antes de que finalice la anterior y decide no sobrescribir la tarea previa. En este caso, la nueva tarea falla. Puede realizar una de las siguientes operaciones: Espere a que finalice la actualización anterior antes de iniciar una nueva. Al iniciar la nueva actualización, elija sobrescribir la tarea anterior. Nota No se puede sobrescribir una tarea de actualización si el dispositivo se encuentra en estado Upgrading. El dispositivo reporta un código de error (-1, -2, -3 o -4) a IoT Platform en el tema de reporte de progreso. Los códigos indican la siguiente información: -1: La actualización falló. -2: La descarga falló. -3: La verificación falló. -4: El flasheo falló. La actualización agotó el tiempo de espera. El sistema inicia un temporizador cuando el dispositivo reporta su progreso por primera vez. Si el dispositivo no reporta el número de versión destino antes de que finalice el periodo de tiempo de espera, la actualización falla. El dispositivo reporta un número de versión que no corresponde ni a la versión de origen ni a la versión destino mientras se encuentra en estado Upgrading. Si especificó una versión de actualización y habilitó los reintentos al crear la tarea de actualización por lotes, el sistema reintentará automáticamente la actualización en los siguientes escenarios de error: La actualización falló porque el dispositivo reportó un número de versión que no correspondía ni a la versión de origen ni a la versión destino mientras estaba en estado Upgrading. La actualización falló porque el dispositivo reportó activamente un error al enviar un valor de -1, -2, -3 o -4 a través del tema de reporte de progreso. Durante un reintento automático, el estado de actualización del dispositivo en la consola de IoT Platform no cambia. Por ejemplo, si se activa un reintento mientras el dispositivo está en estado Pushed, su estado permanece como Pushed. Si se activa un reintento mientras el dispositivo está en estado Upgrading, su estado permanece como Upgrading. Nota IoT Platform no activa reintentos automáticos en los siguientes casos: La actualización falló debido a un tiempo de espera agotado. El motivo del error es timeout. Usted canceló manualmente la actualización.
       Canceled	La actualización para este dispositivo se canceló.

       Si un lote de actualización está en estado Upgrading, aparecerá un botón Edit en la columna Actions. Haga clic en Edit para modificar la Update package push rate en Update policy configuration, como los valores de constant rate o variable rate, o bien para modificar y agregar etiquetas. Para obtener más información, consulte Create a batch update task.

       También puede hacer clic en la pestaña Batch information para consultar la información básica de la tarea de actualización por lotes. Si el lote de actualización está en estado Upgrading, aparecerá un botón Edit junto a Tag information. Haga clic en Edit para modificar o agregar etiquetas.

       En el cuadro de diálogo, introduzca la clave y el valor de la etiqueta para el lote, y luego haga clic en . Las notificaciones del dispositivo utilizarán las nuevas etiquetas en un plazo de un minuto.

     • Haga clic en Cancel en la columna Actions del lote de actualización destino:

       • Para un lote de actualización estático, esta acción cancela el lote y todas sus tareas de actualización asociadas de forma predeterminada, incluidas aquellas en estados Pending Confirmation, To Be Pushed, Pushed y Upgrading.

       • Para un lote de actualización dinámica, esta acción solo cancela la directiva de actualización dinámica de forma predeterminada. Puede elegir si también desea cancelar todas las tareas en curso, incluidas las tareas en estados To Be Pushed, Pushed y Upgrading.

       Puede cancelar todas las tareas de actualización que se encuentren en estado Pending Confirmation, To Be Pushed o Pushed dentro de un lote.

   • Device list

     Consulte los dispositivos destino del paquete de actualización, sus estados de actualización y las estadísticas de tareas actualizadas, fallidas y canceladas.

     Localice un dispositivo destino y haga clic en View en la columna Actions. En la página Batch details, puede cancelar la tarea de actualización para un solo dispositivo o para varios dispositivos.

   • Update package information

     • Consulte la información básica del paquete de actualización, como su ID, nombre, firma, algoritmo de firma, número de versión, estado y módulo.

     • Para descargar el archivo del paquete de actualización, haga clic en Download junto a Update package signature.

Siguientes pasos

View update package versions and success rates: Una vez completadas las actualizaciones OTA, utilice el análisis de datos para consultar la distribución de versiones de paquetes de actualización y las estadísticas de tasa de éxito de actualizaciones.

Referencia de API

Para obtener más información sobre las operaciones de API relacionadas con la función de actualización OTA, consulte OTA update APIs.