Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
En grupp i Azure Device Registry är en frågedefinierad uppsättning homogena resurser som du använder för att rikta åtgärder i hela enhetsflottan, såsom mjukvaruuppdateringar. I den aktuella förhandsvisningen är en grupp avsedd för enheter som är anslutna till IoT Hub. Istället för att hantera enskilda resurser definierar du ett filter en gång och återanvänder den resulterande gruppen där du behöver agera på den uppsättningen resurser.
Important
Azure Device Registry-grupper är för närvarande i förhandsvisning.
Tjänst tillämplighet
| Feature | Azure IoT-åtgärder | Azure IoT Hub |
|---|---|---|
| Groups | Stöds inte i denna förhandsvisning | Preview |
I denna förhandsversion har grupper stöd för IoT Hub-anslutna enheter i ett Azure Device Registry-namespace.
Frågedefinierat medlemskap
Du skapar en grupp genom att definiera ett filter mot stödda resursegenskaper, såsom tillverkare eller mjukvarurevision. I förhandsgranskningen är RegistryDevice den enda stödda Azure-resurstypen. Azure Device Registry utvärderar filtret inom namnrymden och fyller gruppen med varje matchande resurs.
För RegistryDevice grupper, använd egenskapsnamn för frågespråket i frågedefinitionen. Ett exempel:
WHERE manufacturer = 'Contoso' AND model = 'Sensor-v2'
En enhet kan tillhöra mer än en grupp samtidigt. Till exempel kan en enhet matcha både en "firmwareversion 2.1"-grupp och en "byggnad 12"-grupp. Medlemskap är inte exklusivt, så du kan sätta ihop grupper kring olika operativa behov utan att duplicera enheter.
RegistryDevice-egenskaper och operatorer som stöds
Följande tabell visar de stödda egenskaperna och operatorerna för RegistryDevice filterfrågor:
| Användarterminologi | Egenskapsväg | Literaltyp | Operatorer |
|---|---|---|---|
| namnrymd UUID | namespaceUuid |
string |
=, !=, <> |
| name | name |
string |
=, !=, <>, IN, NIN |
| resurstyp | resourceType |
string |
=, !=, <> |
| location | location |
string |
=, !=, <>, IN, NIN |
| enhetens UUID | uuid |
string |
=, !=, <>, IN, NIN |
| etableringstillstånd | provisioningState |
string |
=, !=, <>, IN, NIN |
| extern enhets-ID | externalDeviceId |
string |
=, !=, <>, IN, NIN |
| aktiverad, inaktiverad | enabled |
sträng-enum |
=, !=, <>; värdena är 'Enabled' och 'Disabled' |
| manufacturer | manufacturer |
string |
=, !=, <> |
| model | model |
string |
=, !=, <> |
| Programvarurevision | softwareRevision |
string |
=, !=, <> |
| taggnyckel | tags.<key> |
string |
=, !=, <>; maximalt sökvägsdjup är 4 |
RegistryDevice stöder uppdateringsegenskaper och operatorer
Följande tabell visar de stödda egenskaperna och operatorerna för RegistryDevice filterfrågor inom omfånget attributes.update:
| Egenskapsväg | Literaltyp | Operatorer |
|---|---|---|
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 |
=, !=, <>; maximalt sökvägsdjup är 5 |
attributes.update.agentInfo.agentProfile |
integer |
=, !=, <>, IN, NIN |
Du kan kombinera villkor med AND, OR, NOT, parenteser och jämförelser med null. Skalärfunktioner som STARTSWITH, CONTAINS, IS_NULL och IS_DEFINED, fält-till-fält-jämförelser samt godtyckliga properties.*- eller attributes.*-sökvägar stöds inte.
Cachelagrat medlemskap och uppdatering
Gruppmedlemskap beräknas och cachelagras vid uppdateringstid—det utvärderas inte i realtid. När du skapar en grupp, eller när du uppdaterar en befintlig, utvärderar Azure Device Registry filtret på nytt och uppdaterar den cachade medlemslistan.
Du triggar en gruppuppdatering genom RefreshMembers-operationen. Uppdatering är asynkron, och en grupp kan ha Creating, RefreshingMembers, eller Ready status. Du kan visa medlemmar när gruppen når Ready status.
Eftersom medlemskapet är cachat kan en grupps medlemslista bli inaktuell mellan uppdateringarna. Om en resurss egenskaper ändras, eller en ny resurs börjar matcha filtret, återspeglas inte den förändringen i medlemslistan för en grupp med manuell uppdatering förrän nästa uppdatering är klar. Tjänsten tillämpar ett minsta intervall på en timme mellan manuella uppdateringar.
Immutabla filter och livscykel
Du kan redigera en grupps namn och beskrivning. Filtret är fast vid skapandet; för att rikta in sig på en annan uppsättning enheter, skapa eller klona en grupp med ett nytt filter.
För att rikta in dig på en annan eller justerad uppsättning resurser, skapa en separat grupp med det nya filtret. Att radera en grupp tar bort endast gruppen; dess medlemsenheter finns kvar.
Hantera grupper i Azure portal (förhandsvisning)
I denna förhandsvisning listar sidan Grupper (förhandsvisning) i namnområdesnavigeringen dina grupper och öppnar en gruppdetaljvy. Detaljvyn visar gruppens grundläggande information, en definition av skrivskyddat frågefilter samt aktuellt medlemsantal och senast uppdaterad tid. Eftersom filtret är inställt vid skapandet och inte kan redigeras, använd detaljvyn för att bekräfta vilka enheter en grupp riktar in sig på. Medlemslistan förhandsvisar upp till 10 enheter, så behandla det som en stickprovskontroll snarare än en komplett lista över en stor grupp.
Från grupplistan eller gruppdetaljvyn kan du vidta följande åtgärder:
- Skapa en grupp från listvyn genom att ange ett nödvändigt namn, en valfri beskrivning och ett frågefilter.
- Klona en befintlig grupp från list- eller detaljvyn. Kloning är det praktiska sättet att börja från en grupps definition när du behöver justerade medlemskapskriterier, eftersom du inte kan redigera det ursprungliga filtret.
- Redigera gruppens namn och beskrivning från detaljvyn. Frågefiltret förblir oföränderligt.
- Uppdatera en grupps cachelagrade medlemskap i list- eller detaljvyn, med förbehåll för de uppdateringsgränser som beskrivs i Cachelagrat medlemskap och uppdatering.
- Ta bort en grupp från list- eller detaljvyn. Du bekräftar raderingen genom att ange gruppnamnet.
Relation till jobb och mjukvaruuppdateringar
Grupper existerar oberoende av någon enskild funktion som förbrukar dem. En grupp är en återanvändbar resurs för flotthantering som du kan referera till från flera platser. Till exempel använder en Job en grupp som mål för en standard mjukvaruuppdatering.
Eftersom en grupp kan refereras till av mer än ett jobb eller arbetsflöde kan radering av en grupp eller på annat sätt ändra dess tillgänglighet påverka allt som är beroende av den. Planera ändringar i gruppens livscykel med det beroendet i åtanke.
Begränsningar och förhandsgranskningsbegränsningar
Följande begränsningar gäller för närvarande för grupper:
- Upp till 100 grupper per prenumeration.
- Ett intervall på minst en timme mellan manuella uppdateringar.
-
ListMembersSidstorleken är 1 000, utan filtrering eller sortering i den här förhandsvisningen.