Concetti relativi ai gruppi (anteprima)

Un gruppo in Azure Device Registry è un insieme di risorse omogenee definite da query che utilizzi per indirizzare operazioni su scala flotta, come aggiornamenti software. Nell'anteprima attuale, un gruppo ha come destinazione i dispositivi connessi a hub IoT. Invece di gestire le singole risorse, definisci un filtro una volta e riutilizzi il gruppo risultante ovunque tu debba agire su quel set di risorse.

Importante

I gruppi di Azure Device Registry sono attualmente in anteprima.

Applicabilità del servizio

Feature	Operazioni di Azure IoT	Hub IoT di Azure
Groups	Non supportato in questa anteprima	Preview

In questa anteprima, i gruppi supportano dispositivi connessi a hub IoT in uno spazio dei nomi di Azure Device Registry.

Appartenenza definita per query

Crei un gruppo definendo un filtro in base alle proprietà delle risorse supportate, come il produttore o la revisione software. Nell'anteprima, l'unico tipo di risorsa Azure supportato è RegistryDevice. Azure Device Registry valuta il filtro all'interno dello spazio dei nomi e popola il gruppo con ogni risorsa corrispondente.

Per i RegistryDevice gruppi, usa i nomi delle proprietà del linguaggio di query nella definizione della query. Ad esempio:

WHERE manufacturer = 'Contoso' AND model = 'Sensor-v2'

Un dispositivo può appartenere a più di un gruppo contemporaneamente. Ad esempio, un dispositivo potrebbe corrispondere sia a un gruppo "firmware versione 2.1" sia a un gruppo "building 12". L'appartenenza non è esclusiva, quindi puoi comporre gruppi in base a diverse esigenze operative senza duplicare i dispositivi.

Proprietà e operatori supportati da RegistryDevice

La tabella seguente mostra le proprietà e gli operatori supportati per RegistryDevice le query di filtro:

Terminologia dell'utente	Percorso proprietà	Tipo letterale	Operators
UUID del namespace	namespaceUuid	string	=, !=, <>
nome	name	string	=, !=, <>, IN, NIN
tipo di risorsa	resourceType	string	=, !=, <>
ubicazione	location	string	=, !=, <>, IN, NIN
UUID del dispositivo	uuid	string	=, !=, <>, IN, NIN
Stato del provisioning	provisioningState	string	=, !=, <>, IN, NIN
ID dispositivo esterno	externalDeviceId	string	=, !=, <>, IN, NIN
abilitato, disabilitato	enabled	enumerazione di stringhe	=, !=, <>; i valori sono 'Enabled' e 'Disabled'
manufacturer	manufacturer	string	=, !=, <>
model	model	string	=, !=, <>
Revisione del software	softwareRevision	string	=, !=, <>
chiave del tag	tags.<key>	string	=, !=, <>; la profondità massima del percorso è 4

Proprietà e operatori di aggiornamento supportati da RegistryDevice

La tabella seguente mostra le proprietà supportate e gli operatori per le query di filtro RegistryDevice nell'ambito di attributes.update:

Percorso proprietà	Tipo letterale	Operators
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	=, !=, <>; profondità massima del percorso è 5
attributes.update.agentInfo.agentProfile	integer	=, !=, <>, IN, NIN

Puoi combinare condizioni con AND, OR, NOT, parentesi e confronti con null. Funzioni scalari come STARTSWITH, CONTAINS, IS_NULL e IS_DEFINED, confronti campo a campo e percorsi attributes.* o properties.* arbitrari non sono supportati.

Appartenenza e aggiornamento nella cache

L'appartenenza al gruppo viene calcolata e memorizzata in cache al momento dell'aggiornamento—non viene valutata in tempo reale. Quando crei un gruppo, o quando ne aggiorni uno già esistente, Azure Device Registry rivaluta il filtro e aggiorna la lista dei membri nella cache.

Attivi un aggiornamento di gruppo tramite l'operazione RefreshMembers. L'aggiornamento è asincrono e un gruppo può avere lo stato Creating, RefreshingMembers o Ready. Puoi elencare i membri una volta che il gruppo raggiunge lo stato Ready.

Poiché l'appartenenza al gruppo è archiviata nella cache, la lista dei membri di un gruppo può essere obsoleta tra un refresh e l'altro. Se le proprietà di una risorsa cambiano, o una nuova risorsa inizia a corrispondere al filtro, quella modifica non viene riflessa nella lista dei membri di un gruppo di aggiornamento manuale fino al completamento del prossimo aggiornamento. Il servizio prevede un intervallo minimo di un'ora tra refresh manuali.

Filtri immutabili e ciclo di vita

Puoi modificare il nome e la descrizione di un gruppo. Il filtro è fisso alla creazione; per mirare a un set diverso di dispositivi, crea o clona un gruppo con un nuovo filtro.

Per mirare a un insieme diverso o modificato di risorse, crea un gruppo separato con il nuovo filtro. Eliminando un gruppo, viene rimosso solo il gruppo; i suoi dispositivi membri rimangono.

Gestire i gruppi nel portale Azure (anteprima)

In questa anteprima, la pagina Gruppi (anteprima) nella navigazione dello spazio dei nomi elenca i tuoi gruppi e apre una vista dettagliata del gruppo. La vista dettagliata mostra gli elementi essenziali del gruppo, una definizione del filtro di query di sola lettura, il numero attuale di membri e la data/ora dell'ultimo aggiornamento. Poiché il filtro è impostato alla creazione e non può essere modificato, usa la vista dettagliata per confermare quali dispositivi un gruppo prende di mira. La lista dei membri offre un'anteprima fino a 10 dispositivi, quindi trattala come un controllo a campione piuttosto che come una lista completa di un gruppo numeroso.

Dalla lista dei gruppi o dalla vista dettagliata del gruppo, puoi compiere le seguenti azioni:

• Crea un gruppo dalla vista list fornendo un nome richiesto, una descrizione opzionale e un filtro per le query.
• Clona un gruppo esistente dalla vista list o dettagliata. Il clonaggio è il modo pratico per partire dalla definizione di un gruppo quando serve regolare i criteri di appartenenza, perché non puoi modificare il filtro originale.
• Modifica il nome e la descrizione di un gruppo dalla vista dettagliata. Il filtro delle query rimane immutabile.
• Aggiorna l'appartenenza memorizzata in cache di un gruppo nella vista elenco o dettaglio, soggetta ai limiti di aggiornamento descritti in Appartenenza memorizzata nella cache e aggiornamento.
• Elimina un gruppo dalla vista elenco o dettaglio. Confermi la cancellazione inserendo il nome del gruppo.

Relazione con i processi e gli aggiornamenti software

I gruppi esistono indipendentemente da qualsiasi singola capacità che li consumi. Un gruppo è una risorsa riutilizzabile per la gestione della flotta a cui puoi fare riferimento da più luoghi. Ad esempio, un Job utilizza un gruppo come bersaglio per un'operazione standard di aggiornamento software.

Poiché un gruppo può essere referenziato da più di un lavoro o workflow, eliminare un gruppo o alterarne la disponibilità può influenzare qualsiasi cosa dipenda da esso. Pianifica i cambiamenti del ciclo di vita del gruppo tenendo conto di questa dipendenza.

Limiti e restrizioni di anteprima

I seguenti limiti si applicano attualmente ai gruppi:

• Fino a 100 gruppi per abbonamento.
• Un intervallo minimo di un'ora tra un refresh manuale e l'altro.
• ListMembers dimensione pagina di 1.000, senza filtraggio o ordinamento in questa anteprima.

Contenuti correlati

• Concetti di lavoro (anteprima)
• Concetti relativi agli aggiornamenti software (anteprima)