Implementar una actualización de software en un grupo (versión preliminar)

Para crear un grupo en Azure Portal:

1. En la navegación del espacio de nombres, abre Operaciones>Grupos (versión preliminar) y luego comienza la creación de grupos desde la barra de comandos.

2. En la página Conceptos básicos, introduce un Nombre descriptivo y, opcionalmente, una Descripción que identifica la cohorte de dispositivos prevista.

3. En la página de Definición, bajo Definir condiciones de filtro, introduce una consulta que seleccione los dispositivos conectados al IoT Hub que quieres actualizar.

   

   Los filtros de grupo son inmutables tras la creación. Para usar diferentes criterios de membresía, crea otro grupo con una consulta distinta.

4. En la página de Revisión, verifica Aspectos básicos, Definición y Filtro de consulta, y luego selecciona Crear.

   

Un grupo es un Microsoft.DeviceRegistry/namespaces/groups recurso. El properties.query valor selecciona los dispositivos conectados al IoT Hub registrados que se convierten en miembros del grupo, basándose en propiedades del dispositivo como manufacturer, model, o softwareRevision. Después de crear el grupo, no puedes cambiar su query. Para usar diferentes criterios de membresía, crea otro grupo con una consulta distinta.

Crea un archivo Bicep con el siguiente contenido. Sustituye los valores provisionales, como <NAMESPACE_NAME> y <GROUP_NAME> por los tuyos propios.

param namespaceName string = '<NAMESPACE_NAME>'
param groupName string = 'contoso-tractors'
param groupDescription string = 'Devices to receive the software update'
param groupQuery string = 'WHERE manufacturer = \'contoso\' AND model = \'tractor\''

resource namespace 'Microsoft.DeviceRegistry/namespaces@2026-11-02-preview' existing = {
  name: namespaceName
}

resource group 'Microsoft.DeviceRegistry/namespaces/groups@2026-11-02-preview' = {
  parent: namespace
  name: groupName
  location: namespace.location
  properties: {
    description: groupDescription
    query: groupQuery
  }
}

1. En el portal de Azure, ve a tu Azure Device Registry y selecciona el espacio de nombres que contiene los dispositivos que quieres actualizar.

2. En el espacio de nombres, selecciona Operaciones>Trabajos. La pantalla Tareas muestra una lista de las tareas definidas con su estado, tipo de tarea y grupo de destino. Desde esta pantalla, también puedes ver los grupos y las actualizaciones de software en el espacio de nombres.

   

3. Seleccione Crear para crear una nueva tarea.

4. En la página de Conceptos Básicos , proporciona un nombre y una descripción del puesto.

5. Para el tipo de trabajo, selecciona Actualización de software.

   En la versión preliminar, los tipos de tarea disponibles son Actualización de software y Actualización de incorporación. Una tarea de actualización de software se dirige a un grupo de dispositivos, mientras que una tarea de actualización de incorporación se dirige a los dispositivos que se incorporan a un espacio de nombres. Este artículo trata sobre el trabajo de actualización de software.

6. Selecciona el grupo al que quieres dirigirte. Usa el selector de grupos para buscar y seleccionar un grupo. El selector muestra el número aproximado de dispositivos en cada grupo.

   Para información sobre cómo se actualiza la membresía de grupo, consulte Conceptos de grupos (vista previa).

7. Guardar la selección de grupo. El portal muestra una muestra de los dispositivos del grupo y el número de dispositivos.

8. Define la acción a ejecutar seleccionando una de las actualizaciones de software importadas al espacio de nombres. Cada actualización de software incluye una comprobación de compatibilidad que determina si se aplica a un dispositivo. El portal realiza una comprobación de compatibilidad para el grupo seleccionado para determinar si la actualización de software es compatible.

   

9. Selecciona Siguiente para ver un resumen del trabajo. El resumen muestra el número de miembros del grupo y una estimación del número de miembros compatibles que el trabajo probablemente actualizará con éxito.

   

10. Selecciona Crear. El estado del trabajo muestra Creando y luego cambia a Listo tras un momento.

Un trabajo de actualización de software es un recurso Microsoft.DeviceRegistry/namespaces/jobs con properties.jobType configurado en SoftwareUpdate. La target.resourceId propiedad hace referencia al grupo al que el trabajo aplica la actualización y debe ser un ID de recurso para un Microsoft.DeviceRegistry/namespaces/groups recurso en el mismo espacio de nombres. La propiedad definition.update.updateId identifica la actualización de software que se va a aplicar por su proveedor, nombre y versión. Actualmente, definition.schedulingType solo soporta el valor Continuous.

Después de crear la tarea, sus propiedades —incluyendo target y definition— son inmutables. Para cambiar el grupo de destino o la definición de la actualización, elimine la tarea y cree una nueva.

Crea un archivo Bicep con el siguiente contenido. Sustituye los valores provisionales, como <NAMESPACE_NAME>, <GROUP_NAME>, y los valores del identificador de actualización, por los tuyos propios.

param namespaceName string = '<NAMESPACE_NAME>'
param jobName string = '<JOB_NAME>'
param groupName string = '<GROUP_NAME>'
param updateProvider string = '<UPDATE_PROVIDER>'
param updateName string = '<UPDATE_NAME>'
param updateVersion string = '<UPDATE_VERSION>'

resource namespace 'Microsoft.DeviceRegistry/namespaces@2026-11-02-preview' existing = {
  name: namespaceName
}

resource group 'Microsoft.DeviceRegistry/namespaces/groups@2026-11-02-preview' existing = {
  parent: namespace
  name: groupName
}

resource softwareUpdateJob 'Microsoft.DeviceRegistry/namespaces/jobs@2026-11-02-preview' = {
  parent: namespace
  name: jobName
  location: namespace.location
  properties: {
    description: 'Software update job'
    jobType: 'SoftwareUpdate'
    target: {
      resourceId: group.id
    }
    definition: {
      schedulingType: 'Continuous'
      update: {
        updateId: {
          provider: updateProvider
          name: updateName
          version: updateVersion
        }
      }
    }
  }
}

1. En la pantalla Trabajos, selecciona el trabajo que quieres ejecutar.

2. Seleccione una de las siguientes opciones:

   • Corre ahora: La tarea se ejecuta inmediatamente.
   • Programa para más tarde: Elige una hora en los próximos siete días. El trabajo se ejecuta a la hora que selecciones.

Una vez ejecutada o programada la tarea, el portal pasa a la pestaña Ejecuciones.

Bicep declara recursos, así que no puede activar directamente una acción como correr o programar un trabajo. En su lugar, utilice la acción schedule de la tarea, a la que puede acceder mediante la CLI de Azure. Para ejecutar el trabajo inmediatamente, omite scheduledTime. Para programar la tarea, incluye un valor scheduledTime.

az rest --method post \
  --uri "https://management.azure.com/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.DeviceRegistry/namespaces/<NAMESPACE_NAME>/jobs/<JOB_NAME>/schedule?api-version=2026-11-02-preview" \
  --body '{
    "scheduledTime": "2026-11-15T14:30:00Z",
    "timeout": "PT1H"
  }'

• scheduledTime: La fecha y hora UTC para ejecutar el trabajo. Omite esta propiedad para ejecutar el trabajo inmediatamente.
• timeout: Una duración ISO 8601 que limita cuánto tiempo se permite que dure la ejecución, por ejemplo PT1H para una hora. Esta propiedad es opcional.

Después de ejecutar o programar el trabajo, usa el portal de Azure o las APIs de ejecución de trabajos para monitorizar la ejecución.

1. Selecciona la pestaña Runs para ver las ejecuciones y su estado.

2. Selecciona una ejecución completada para ver sus estadísticas. Los detalles de la ejecución muestran el número de dispositivos actualizados y los detalles de esos dispositivos.

3. Revisa un dispositivo específico. Para confirmar si un dispositivo específico ha sido actualizado, utiliza el cuadro de búsqueda en los detalles de la ejecución para encontrar el dispositivo.

Las ejecuciones de trabajos son recursos de solo lectura, así que los monitorizas consultando el Microsoft.DeviceRegistry/namespaces/jobs/runs tipo de recurso en lugar de declararlos en Bicep. Usa CLI de Azure para listar las ejecuciones del trabajo y comprobar su estado:

az rest --method get \
  --uri "https://management.azure.com/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.DeviceRegistry/namespaces/<NAMESPACE_NAME>/jobs/<JOB_NAME>/runs?api-version=2026-11-02-preview"

Cada ejecución incluye un valor status, como Scheduled, Running o Ended, y un resumen results con el recuento de dispositivos que han tenido éxito, han fallado, están en curso, pendientes o se han cancelado.

Para comprobar un dispositivo específico, obtén los resultados de una ejecución y filtra por estado:

az rest --method post \
  --uri "https://management.azure.com/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.DeviceRegistry/namespaces/<NAMESPACE_NAME>/jobs/<JOB_NAME>/runs/<RUN_NAME>/listResults?api-version=2026-11-02-preview" \
  --body '{
    "filter": "status eq '\''Failed'\''"
  }'

Cada entrada en los resultados identifica el dispositivo de destino y su estado por dispositivo. Omite la propiedad filter en el cuerpo de la solicitud para obtener todos los resultados de los dispositivos de la ejecución.