Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Un grupo en Azure Device Registry es un conjunto de recursos homogéneos definidos por consultas que se utilizan para dirigir operaciones a escala de flota, como actualizaciones de software. En la vista previa actual, un grupo se dirige a dispositivos conectados al IoT Hub. En lugar de gestionar recursos individuales, defines un filtro una vez y reutilizas el grupo resultante donde necesites actuar sobre ese conjunto de recursos.
Importante
Los grupos del Registro de Dispositivos de Azure están actualmente en vista previa.
Aplicabilidad del servicio
| Feature | Operaciones de Azure IoT | Azure IoT Hub |
|---|---|---|
| Groups | No se admite en esta vista previa | Preview |
En esta vista previa, los grupos soportan dispositivos conectados a IoT Hub en un espacio de nombres de Azure Device Registry.
Pertenencia definida por consulta
Se crea un grupo definiendo un filtro según propiedades de recursos soportados, como el fabricante o la revisión de software. En la vista previa, el único tipo de recurso de Azure soportado es RegistryDevice. Azure Device Registry evalúa el filtro dentro del espacio de nombres y llena el grupo con todos los recursos correspondientes.
Para grupos RegistryDevice , utiliza nombres de propiedades del lenguaje de consulta en la definición de consulta. Por ejemplo:
WHERE manufacturer = 'Contoso' AND model = 'Sensor-v2'
Un dispositivo puede pertenecer a más de un grupo al mismo tiempo. Por ejemplo, un dispositivo podría coincidir tanto con un grupo de "firmware versión 2.1" como con un grupo de "edificio 12". La pertenencia no es exclusiva, así que puedes componer grupos según diferentes necesidades operativas sin duplicar dispositivos.
Propiedades y operadores compatibles con RegistryDevice
La siguiente tabla muestra las propiedades y operadores soportados para las consultas de filtro RegistryDevice:
| Terminología del usuario | Ruta de acceso a la propiedad | Tipo literal | Operadores |
|---|---|---|---|
| UUID de espacio de nombres | namespaceUuid |
string |
=, !=, <> |
| nombre | name |
string |
=, !=, <>, IN, NIN |
| tipo de recurso | resourceType |
string |
=, !=, <> |
| location | location |
string |
=, !=, <>, IN, NIN |
| UUID de dispositivo | uuid |
string |
=, !=, <>, IN, NIN |
| Estado de provisión | provisioningState |
string |
=, !=, <>, IN, NIN |
| ID externo de dispositivo | externalDeviceId |
string |
=, !=, <>, IN, NIN |
| habilitado, deshabilitado | enabled |
string enum |
=, !=, <>; los valores son 'Enabled' y 'Disabled' |
| manufacturer | manufacturer |
string |
=, !=, <> |
| model | model |
string |
=, !=, <> |
| Revisión de software | softwareRevision |
string |
=, !=, <> |
| clave de etiqueta | tags.<key> |
string |
=, !=, <>; la profundidad máxima de camino es 4 |
Propiedades y operadores de actualización compatibles de RegistryDevice
La siguiente tabla muestra las propiedades y operadores soportados para RegistryDevice consultas de filtro dentro del attributes.update ámbito:
| Ruta de acceso a la propiedad | Tipo literal | Operadores |
|---|---|---|
attributes.update.deviceClassId |
string |
=, !=, <>, IN, NIN |
attributes.update.installedUpdateId.provider |
string |
=, !=, <>, IN, NIN |
attributes.update.installedUpdateId.name |
string |
=, !=, <>, IN, NIN |
attributes.update.installedUpdateId.version |
string |
=, !=, <>, IN, NIN |
attributes.update.latestUpdateJobInfo.state |
string |
=, !=, <>, IN, NIN |
attributes.update.latestUpdateJobInfo.updateId.provider |
string |
=, !=, <>, IN, NIN |
attributes.update.latestUpdateJobInfo.updateId.name |
string |
=, !=, <>, IN, NIN |
attributes.update.latestUpdateJobInfo.updateId.version |
string |
=, !=, <>, IN, NIN |
attributes.update.agentInfo.compatibilityProperties.<key> |
string |
=, !=, <>; la profundidad máxima de camino es 5 |
attributes.update.agentInfo.agentProfile |
integer |
=, !=, <>, IN, NIN |
Puedes combinar condiciones con AND, OR, NOT, paréntesis y comparaciones respecto a null. No se soportan funciones escalares como STARTSWITH, CONTAINS, IS_NULL y IS_DEFINED, comparaciones de campo a campo ni rutas properties.* o attributes.* arbitrarias.
Membresía en caché y actualización
La membresía del grupo se calcula y almacena en caché en tiempo de refresco; no se evalúa en tiempo real. Cuando creas un grupo, o cuando actualizas uno existente, Azure Device Registry reevalúa el filtro y actualiza la lista de miembros en caché.
Activas una actualización de grupo mediante la operación RefreshMembers. La actualización es asíncrona y un grupo puede tener el estado Creating, RefreshingMembers o Ready. Puede enumerar los miembros una vez que el grupo alcance el estado Ready.
Como la membresía está almacenada en caché, la lista de miembros de un grupo puede quedar obsoleta entre actualizaciones. Si cambian las propiedades de un recurso, o un recurso nuevo empieza a coincidir con el filtro, ese cambio no se refleja en la lista de miembros de un grupo de actualización manual hasta que se completa el siguiente refresco. El servicio exige un intervalo mínimo de una hora entre refrescos manuales.
Filtros inmutables y ciclo de vida
Puedes editar el nombre y la descripción de un grupo. El filtro se fija en la creación; para dirigirse a un conjunto diferente de dispositivos, crea o clona un grupo con un nuevo filtro.
Para dirigirte a un conjunto diferente o ajustado de recursos, crea un grupo separado con el nuevo filtro. Eliminar un grupo solo elimina el grupo; sus dispositivos miembros permanecen.
Administrar grupos en Azure portal (versión preliminar)
En esta vista previa, la página de Grupos (vista previa) en la navegación del espacio de nombres lista tus grupos y abre una vista de detalle de grupo. La vista de detalle muestra los elementos esenciales del grupo, una definición de filtro de consulta de solo lectura, el número actual de miembros y la fecha y hora de la última actualización. Como el filtro está configurado en la creación y no se puede editar, usa la vista de detalle para confirmar a qué dispositivos se dirige un grupo. La vista previa de la lista de miembros muestra hasta 10 dispositivos, así que considérela como una comprobación aleatoria y no como una lista completa de un grupo grande.
Desde la lista de grupos o la vista de detalle del grupo, puedes realizar las siguientes acciones:
- Crea un grupo desde la vista de lista proporcionando un nombre obligatorio, una descripción opcional y un filtro de consultas.
- Clona un grupo existente desde la vista de lista o detalles. La clonación es la forma práctica de empezar desde la definición de un grupo cuando necesitas ajustar los criterios de membresía, porque no puedes editar el filtro original.
- Edite el nombre y la descripción de un grupo en la vista de detalles. El filtro de consulta permanece inmutable.
- Actualice la pertenencia en caché de un grupo en la lista o en la vista de detalle, de acuerdo con los límites de actualización descritos en Pertenencia y actualización en caché.
- Elimina un grupo de la vista de lista o detalles. Confirmas la eliminación introduciendo el nombre del grupo.
Relación con trabajos y actualizaciones de software
Los grupos existen independientemente de cualquier capacidad individual que los consuma. Un grupo es un recurso reutilizable de gestión de flotas al que puedes hacer referencia desde varios sitios. Por ejemplo, un Job utiliza un grupo como destino para una operación estándar de actualización de software.
Como un grupo puede ser referenciado por más de un trabajo o flujo de trabajo, eliminar un grupo o cambiar su disponibilidad puede afectar a cualquier cosa que dependa de él. Planifique los cambios del ciclo de vida del grupo de planificación teniendo en cuenta esa dependencia.
Límites y restricciones de previsualización
Los siguientes límites se aplican actualmente a los grupos:
- Hasta 100 grupos por suscripción.
- Un intervalo mínimo de una hora entre refrescos manuales.
-
ListMembersTamaño de página de 1.000, sin filtrado ni ordenación en esta vista previa.