Principy pro skupiny (náhled)

Skupina v Azure Device Registry je dotazem definovaná sada homogenních zdrojů, které používáte k cílení operací na úrovni flotily, například k aktualizacím softwaru. V aktuálním náhledu se skupina zaměřuje na zařízení připojená k IoT Hub. Místo správy jednotlivých zdrojů si filtr vytvoříte jednou a výslednou skupinu použijete tam, kde potřebujete na dané sadě zdrojů jednat.

Diagram zobrazující softwarovou aktualizační úlohu zaměřenou na skupinu zařízení a úlohu aktualizace onboardingu zaměřenou na zařízení zařazovaná do jmenného prostoru Azure Device Registry.

Important

Skupiny Azure Device Registry jsou momentálně ve verzi preview.

Použitelnost služby

Feature Operace Azure IoT Azure IoT Hub
Groups V této verzi Preview není podporováno Náhled

V této verzi Preview skupiny podporují zařízení připojená ke službě IoT Hub v oboru názvů Azure Device Registry.

Členství definované dotazem

Skupinu vytvoříte definováním filtru pro podporované vlastnosti prostředků, jako je výrobce nebo revize softwaru. Ve verzi Preview je jediným podporovaným typem prostředku Azure RegistryDevice. Azure Device Registry vyhodnocuje filtr v jmenném prostoru a naplní skupinu všemi odpovídajícími zdroji.

Pro RegistryDevice skupiny použijte názvy vlastností v dotazovacím jazyce v definici dotazu. Příklady:

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

Zařízení může patřit do více skupin najednou. Například zařízení může odpovídat jak skupině "firmware verze 2.1", tak skupině "building 12". Členství není exkluzivní, takže můžete sestavovat skupiny podle různých provozních potřeb bez duplikování zařízení.

Podporované vlastnosti a operátory zařízení RegistryDevice

Následující tabulka ukazuje podporované vlastnosti a operátory pro RegistryDevice filtrační dotazy:

Uživatelská terminologie Cesta k vlastnosti Typ literálu Operators
Jmenný prostor UUID namespaceUuid řetězec =, !=, <>
název name řetězec =, !=, <>, , INNIN
typ prostředku resourceType řetězec =, !=, <>
poloha location řetězec =, !=, <>, , INNIN
UUID zařízení uuid řetězec =, !=, <>, , INNIN
stav zřizování provisioningState řetězec =, !=, <>, , INNIN
Externí ID zařízení externalDeviceId řetězec =, !=, <>, , INNIN
povoleno, zakázáno enabled string – výčet =, !=, <>; hodnoty jsou 'Enabled' a 'Disabled'
výrobce manufacturer řetězec =, !=, <>
model model řetězec =, !=, <>
Verze softwaru softwareRevision řetězec =, !=, <>
Klíč značky tags.<key> řetězec =, !=, <>; maximální hloubka cesty je 4

RegistryDevice podporované vlastnosti a operátory aktualizací

Následující tabulka ukazuje podporované vlastnosti a operátory pro RegistryDevice filtrační dotazy v rámci attributes.update:

Cesta k vlastnosti Typ literálu Operators
attributes.update.deviceClassId řetězec =, !=, <>, , INNIN
attributes.update.installedUpdateId.provider řetězec =, !=, <>, , INNIN
attributes.update.installedUpdateId.name řetězec =, !=, <>, , INNIN
attributes.update.installedUpdateId.version řetězec =, !=, <>, , INNIN
attributes.update.latestUpdateJobInfo.state řetězec =, !=, <>, , INNIN
attributes.update.latestUpdateJobInfo.updateId.provider řetězec =, !=, <>, , INNIN
attributes.update.latestUpdateJobInfo.updateId.name řetězec =, !=, <>, , INNIN
attributes.update.latestUpdateJobInfo.updateId.version řetězec =, !=, <>, , INNIN
attributes.update.agentInfo.compatibilityProperties.<key> řetězec =, !=, <>; maximální hloubka dráhy je 5
attributes.update.agentInfo.agentProfile integer =, !=, <>, , INNIN

Můžete kombinovat podmínky s AND, OR, NOT, závorkami a porovnáními s null. Skalární funkce jako STARTSWITH, CONTAINS, IS_NULL a IS_DEFINED, porovnání pole s polem a libovolné cesty attributes.* nebo properties.* nejsou podporovány.

Členství uložené v mezipaměti a obnova

Členství ve skupině se počítá a ukládá do mezipaměti při obnovení – není vyhodnocováno v reálném čase. Když vytvoříte skupinu nebo obnovíte existující, Azure Device Registry znovu vyhodnotí filtr a aktualizuje cacheovaný seznam členů.

Pomocí operace RefreshMembers spustíte obnovení skupiny. Obnova je asynchronní a skupina může mít Creating, RefreshingMembers, nebo Ready stav. Jakmile skupina dosáhne statusu Ready, můžete vypsat členy.

Protože členství je uloženo do mezipaměti, může být seznam členů skupiny mezi obnovami zastaralý. Pokud se vlastnosti zdroje změní, nebo nový zdroj začne odpovídat filtru, tato změna se v seznamu členů skupiny s ručním obnovením neprojeví, dokud nedokončí další obnovení. Služba vyžaduje minimální hodinový interval mezi ručními obnovami.

Neměnné filtry a lifecycle

Můžete upravit název a popis skupiny. Filtr je pevně daný při vytvoření; pro cílení na jinou sadu zařízení lze vytvořit nebo klonovat skupinu s novým filtrem.

Pro cílení na jinou nebo upravenou sadu zdrojů vytvořte samostatnou skupinu s novým filtrem. Smazání skupiny odstraní pouze skupinu; její členská zařízení zůstávají.

Spravovat skupiny v portálu Azure (verze Preview)

V tomto náhledu stránka Skupiny (náhled) v navigaci jmenného prostoru uvádí vaše skupiny a otevírá detailní zobrazení skupiny. Detailní pohled ukazuje základní informace skupiny, definici filtru dotazů pouze pro čtení, aktuální počet členů a čas poslední aktualizace. Protože filtr je nastaven při vytvoření a nelze ho upravovat, použijte detailní zobrazení k ověření, na která zařízení skupina cílí. Seznam členů zobrazuje náhled až 10 zařízení, takže jej berte spíše jako namátkovou kontrolu než jako kompletní seznam velké skupiny.

Ze seznamu skupin nebo v zobrazení detailů skupin můžete provést následující kroky:

  • Vytvořte skupinu z pohledu seznamu zadáním požadovaného jména, volitelného popisu a filtru dotazu.
  • Klonujte existující skupinu z pohledu seznamu nebo detailů. Klonování je praktický způsob, jak vycházet z definice skupiny, když potřebujete upravit kritéria členství, protože zdrojový filtr nelze upravovat.
  • Upravte název a popis skupiny z detailního pohledu. Filtr dotazů zůstává neměnný.
  • Obnovte členství skupiny v mezipaměti v seznamu nebo detailním zobrazení, s ohledem na limity obnovy popsané v Členství v mezipaměti a aktualizace.
  • Smažte skupinu ze seznamu nebo z pohledu detailů. Smazání potvrzujete zadáním názvu skupiny.

Vztah k úlohám a aktualizacím softwaru

Skupiny existují nezávisle na jakékoli jediné funkci, která je využívá. Skupina je znovupoužitelný zdroj pro správu vozového parku, na který můžete odkazovat z více míst. Například úloha používá skupinu jako cíl pro standardní aktualizaci softwaru.

Protože na skupinu může odkazovat více než jedna pracovní pozice nebo pracovní postup, smazání skupiny nebo jiná změna její dostupnosti může ovlivnit cokoli, co na ní závisí. Plánujte změny životního cyklu skupiny s ohledem na tuto závislost.

Limity a omezení verze Preview

Následující limity v současnosti platí pro skupiny:

  • Až 100 skupin na jedno předplatné.
  • Mezi ručními obnoveními musí být alespoň jedna hodina.
  • ListMembers Velikost stránky je 1 000, bez filtrování nebo třídění v tomto náhledu.

Související obsah

  • Poslední aktualizace v