Gruppenkonzepte (Vorschau)

Eine Gruppe im Azure Device Registry ist eine abfragedefinierte Menge homogener Ressourcen, die Sie nutzen, um Flottenvorgänge wie Software-Updates gezielt anzusprechen. In der aktuellen Vorschau zielt eine Gruppe auf mit IoT Hub verbundene Geräte ab. Anstatt einzelne Ressourcen zu verwalten, definierst du einen Filter einmal und verwendest die resultierende Gruppe dort, wo du Aktionen für diesen Ressourcensatz ausführen musst.

Wichtig

Die Azure Device Registry-Gruppen befinden sich derzeit in der Vorschau.

Anwendbarkeit des Dienstes

Feature	Azure IoT-Vorgänge	Azure IoT Hub
Groups	Nicht in dieser Vorschau unterstützt	Preview

In dieser Vorschau unterstützen Gruppen IoT Hub-verbundene Geräte in einem Azure Device Registry-Namensraum.

Abfragebasierte Mitgliedschaft

Man erstellt eine Gruppe, indem man einen Filter anhand unterstützter Ressourceneigenschaften definiert, wie Hersteller oder Softwarerevision. In der Vorschau ist der einzige unterstützte Azure-Ressourcentyp RegistryDevice. Azure Device Registry bewertet den Filter im Namespace und füllt die Gruppe mit jeder passenden Ressource.

Für RegistryDevice-Gruppen verwenden Sie in der Abfragedefinition Eigenschaftsnamen der Abfragesprache. Beispiele:

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

Ein Gerät kann gleichzeitig mehr als einer Gruppe angehören. Zum Beispiel könnte ein Gerät sowohl einer „Firmware-Version 2.1“-Gruppe als auch einer „Building 12“-Gruppe entsprechen. Die Mitgliedschaft ist nicht exklusiv, sodass Sie Gruppen um unterschiedliche operative Anforderungen herum zusammenstellen können, ohne Geräte zu duplizieren.

Vom RegistryDevice unterstützte Eigenschaften und Operatoren

Die folgende Tabelle zeigt die unterstützten Eigenschaften und Operatoren für RegistryDevice Filterabfragen:

Benutzerterminologie	Eigenschaftspfad	Literaltyp	Betriebspersonal
Namespace UUID	namespaceUuid	string	=, !=, <>
Name	name	string	=, !=, <>, IN, , NIN
Ressourcentyp	resourceType	string	=, !=, <>
location	location	string	=, !=, <>, IN, , NIN
Geräte-UUID	uuid	string	=, !=, <>, IN, , NIN
Bereitstellungsstatus	provisioningState	string	=, !=, <>, IN, , NIN
externe Geräte-ID	externalDeviceId	string	=, !=, <>, IN, , NIN
Aktiviert, deaktiviert	enabled	String-Enum	=, !=, <>; die Werte sind 'Enabled' und 'Disabled'
manufacturer	manufacturer	string	=, !=, <>
model	model	string	=, !=, <>
Softwarerevision	softwareRevision	string	=, !=, <>
Tag-Schlüssel	tags.<key>	string	=, !=, <>; maximale Pfadtiefe beträgt 4

RegistryDevice unterstützte Aktualisierungseigenschaften und -operatoren

Die folgende Tabelle zeigt die unterstützten Eigenschaften und Operatoren für RegistryDevice Filterabfragen innerhalb des Scopes attributes.update :

Eigenschaftspfad	Literaltyp	Betriebspersonal
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	=, !=, <>; die maximale Pfadtiefe beträgt 5
attributes.update.agentInfo.agentProfile	integer	=, !=, <>, IN, , NIN

Sie können Bedingungen mit AND, OR, NOT, Klammern und Vergleiche mit null kombinieren. Skalare Funktionen wie STARTSWITH, CONTAINS, IS_NULL, und IS_DEFINED, Feld-zu-Feld-Vergleiche sowie beliebige properties.* oder attributes.* Pfade werden nicht unterstützt.

Zwischengespeicherter Mitgliedschaftsstatus und Aktualisierung

Die Gruppenmitgliedschaft wird zur Aktualisierungszeit berechnet und zwischengespeichert – sie wird nicht in Echtzeit ausgewertet. Wenn Sie eine Gruppe erstellen oder eine bestehende aktualisieren, bewertet die Azure Device Registry den Filter neu und aktualisiert die zwischengespeicherte Mitgliederliste.

Man löst eine Gruppen-Aktualisierung durch den Vorgang RefreshMembers aus. Refresh ist asynchron, und eine Gruppe kann den Status RefreshingMembers, Ready oder Creating haben. Du kannst Mitglieder auflisten, sobald die Gruppe den Ready-Status erreicht hat.

Da die Mitgliedschaft zwischengespeichert ist, kann die Mitgliederliste einer Gruppe zwischen den Aktualisierungen veraltet sein. Wenn sich die Eigenschaften einer Ressource ändern oder eine neue Ressource beginnt, dem Filter zu entsprechen, wird diese Änderung erst in der Mitgliederliste einer manuellen Aktualisierungsgruppe widergespiegelt, wenn die nächste Aktualisierung abgeschlossen ist. Der Dienst setzt ein Mindestintervall von einer Stunde zwischen manuellen Aktualisierungen voraus.

Unveränderliche Filter und Lebenszyklus

Du kannst den Namen und die Beschreibung einer Gruppe bearbeiten. Der Filter ist bei der Erstellung festgelegt; um eine andere Gruppe von Geräten anzusprechen, erstellen oder klonen Sie eine Gruppe mit einem neuen Filter.

Um einen anderen oder angepassten Satz von Ressourcen auszuwählen, erstellen Sie eine separate Gruppe mit dem neuen Filter. Das Löschen einer Gruppe entfernt nur die Gruppe; ihre Mitgliedsgeräte bleiben erhalten.

Verwalten von Gruppen im Azure Portal (Vorschau)

In dieser Vorschau listet die Seite Gruppen (Vorschau) in der Namensraum-Navigation Ihre Gruppen auf und öffnet eine Gruppendetailansicht. Die Detailansicht zeigt die Grundinformationen der Gruppe, eine schreibgeschützte Definition des Abfragefilters sowie die aktuelle Mitgliederzahl und die zuletzt aktualisierte Zeit. Da der Filter bei der Erstellung eingestellt ist und nicht bearbeitet werden kann, verwenden Sie die Detailansicht, um zu bestätigen, welche Geräte eine Gruppe anvisiert. Die Mitgliederliste gibt eine Vorschau auf bis zu 10 Geräte, daher sollte man es als Stichprobe und nicht als vollständige Auflistung einer großen Gruppe betrachten.

Aus der Gruppenliste oder der Gruppendetailansicht können Sie folgende Maßnahmen ausführen:

• Erstellen Sie eine Gruppe aus der Listenansicht, indem Sie einen erforderlichen Namen, eine optionale Beschreibung und einen Abfragefilter angeben.
• Klonen Sie eine bestehende Gruppe aus der Listen- oder Detailansicht. Klonen ist der praktische Weg, mit der Definition einer Gruppe zu beginnen, wenn man angepasste Mitgliedschaftskriterien benötigt, weil man den ursprünglichen Filter nicht bearbeiten kann.
• Bearbeiten Sie den Namen und die Beschreibung einer Gruppe in der Detailansicht. Der Abfragefilter bleibt unveränderlich.
• Aktualisieren Sie die zwischengespeicherte Mitgliedschaft einer Gruppe in der Listen- oder Detailansicht, vorbehaltlich der Aktualisierungsbeschränkungen, die in Zwischengespeicherte Mitgliedschaft und Aktualisierung beschrieben sind.
• Löschen Sie eine Gruppe aus der Liste oder der Detailansicht. Du bestätigst die Löschung, indem du den Gruppennamen eingibst.

Beziehung zu Jobs und Software-Updates

Gruppen existieren unabhängig von einer einzelnen Capability, die sie verbraucht. Eine Gruppe ist eine wiederverwendbare Flottenverwaltungsressource, auf die man von mehreren Orten zurückgreifen kann. Zum Beispiel verwendet ein Job eine Gruppe als Ziel für eine Standard-Software-Update-Operation.

Da eine Gruppe von mehr als einem Job oder Workflow referenziert werden kann, kann das Löschen einer Gruppe oder das anderweitige Ändern ihrer Verfügbarkeit alles beeinflussen, was davon abhängt. Plane Gruppenlebenszyklusänderungen mit dieser Abhängigkeit im Hinterkopf.

Einschränkungen und Vorschaubeschränkungen

Für Gruppen gelten derzeit folgende Beschränkungen:

• Bis zu 100 Gruppen pro Abo.
• Ein Mindestabstand von einer Stunde zwischen manuellen Aktualisierungen.
• ListMembers Seitengröße ist 1.000, ohne Filterung oder Sortierung in dieser Vorschau.

Verwandte Inhalte

• Jobs-Konzepte (Vorschau)
• Software-Update-Konzepte (Vorschau)