Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Een groep in Azure Device Registry is een door een query gedefinieerde verzameling van homogene resources die je gebruikt om vlootoperaties op grote schaal te richten op, zoals software-updates. In de huidige preview richt een groep zich op apparaten die met IoT Hub zijn verbonden. In plaats van individuele resources te beheren, definieer je één filter en hergebruik je de resulterende groep overal waar je op die set resources moet acteren.
Important
Azure Device Registry-groepen zijn momenteel in preview.
Toepasselijkheid van service
| Feature | Azure IoT-bewerkingen | Azure IoT Hub |
|---|---|---|
| Groups | Niet ondersteund in deze preview | Preview |
In deze preview ondersteunen groepen met IoT Hub verbonden apparaten in een Azure Device Registry-naamruimte.
Lidmaatschap op basis van query
Je maakt een groep aan door een filter te definiëren op basis van ondersteunde resource-eigenschappen, zoals fabrikant of softwarerevisie. In de preview is RegistryDevicehet enige ondersteunde Azure-resourcetype . Azure Device Registry evalueert het filter binnen de naamruimte en vult de groep met elke overeenkomende resource.
Voor RegistryDevice groepen gebruik je eigenschapsnamen van query-taal in de querydefinitie. Voorbeeld:
WHERE manufacturer = 'Contoso' AND model = 'Sensor-v2'
Een apparaat kan tegelijkertijd tot meer dan één groep behoren. Een apparaat kan bijvoorbeeld overeenkomen met zowel een "firmwareversie 2.1"-groep als een "building 12"-groep. Lidmaatschap is niet exclusief, dus je kunt groepen samenstellen rond verschillende operationele behoeften zonder apparaten te dupliceren.
RegistryDevice ondersteunde eigenschappen en operators
De volgende tabel toont de ondersteunde eigenschappen en operatoren voor RegistryDevice filterzoekopdrachten:
| Gebruikersterminologie | Eigenschapspad | Letterlijk type | Operatoren |
|---|---|---|---|
| namespace UUID | namespaceUuid |
string |
=, !=, <> |
| naam | name |
string |
=, !=, <>, IN, , NIN |
| resourcetype | resourceType |
string |
=, !=, <> |
| location | location |
string |
=, !=, <>, IN, , NIN |
| UUID van het apparaat | uuid |
string |
=, !=, <>, IN, , NIN |
| inrichtingsstatus | provisioningState |
string |
=, !=, <>, IN, , NIN |
| externe apparaat-ID | externalDeviceId |
string |
=, !=, <>, IN, , NIN |
| ingeschakeld, uitgeschakeld | enabled |
string-enum |
=, !=, <>; de waarden zijn 'Enabled' en 'Disabled' |
| manufacturer | manufacturer |
string |
=, !=, <> |
| model | model |
string |
=, !=, <> |
| softwareversie | softwareRevision |
string |
=, !=, <> |
| Tagsleutel | tags.<key> |
string |
=, !=, <>; maximale paddiepte is 4 |
RegistryDevice ondersteunde update-eigenschappen en -operatoren
De volgende tabel toont de ondersteunde eigenschappen en operatoren voor RegistryDevice filterqueries binnen de attributes.update scope:
| Eigenschapspad | Letterlijk type | Operatoren |
|---|---|---|
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 |
=, !=, <>; maximale paddiepte is 5 |
attributes.update.agentInfo.agentProfile |
integer |
=, !=, <>, IN, , NIN |
Je kunt voorwaarden combineren met AND, NOT, null, haakjes, en vergelijkingen met OR. Scalaire functies zoals STARTSWITH, CONTAINS, IS_NULL, en IS_DEFINED, veld-tot-veld vergelijkingen, en willekeurige properties.* of attributes.* paden worden niet ondersteund.
In cache opgeslagen lidmaatschap en verversen
Groepslidmaatschap wordt berekend en gecachet bij het verversen – het wordt niet in realtime geëvalueerd. Wanneer je een groep aanmaakt of een bestaande ververst, evalueert Azure Device Registry het filter opnieuw en werkt de gecachte ledenlijst bij.
Je activeert een groepsvernieuwing via de RefreshMembers-bewerking. Verversen is asynchroon, en een groep kan RefreshingMembers, Ready, of Creating status hebben. Je kunt leden vermelden zodra de groep de status Ready bereikt.
Omdat het lidmaatschap wordt gecachet, kan de ledenlijst van een groep tussen verversingen door verouderd zijn. Als de eigenschappen van een resource veranderen, of een nieuwe resource begint met het filter te matchen, wordt die wijziging pas weergegeven in de ledenlijst van een handmatige verversgroep als de volgende verversing is voltooid. De dienst handhaaft een minimaal interval van één uur tussen handmatige verversingen.
Immutable filters en levenscyclusbeheer
Je kunt de naam en beschrijving van een groep bewerken. Het filter is bij het aanmaken vastgelegd; om een andere set apparaten te targeten, maak of kloon je een groep met een nieuw filter.
Om een andere of aangepaste set resources te targeten, maak je een aparte groep aan met het nieuwe filter. Het verwijderen van een groep verwijdert alleen de groep; de lidapparaten blijven over.
Beheer groepen in het Azure portal (preview)
In deze preview toont de Groepen (preview) pagina in de navigatie in de naamruimte je groepen en opent een groepsdetailweergave. De detailweergave toont de basisgegevens van de groep, een alleen-lezen queryfilterdefinitie, en het huidige aantal leden en de laatst bijgewerkte tijd. Omdat het filter bij het aanmaken is ingesteld en niet bewerkt kan worden, gebruik de detailweergave om te bevestigen welke apparaten een groep target. De ledenlijst geeft een preview van maximaal 10 apparaten, dus behandel het als een steekproef in plaats van een volledige lijst van een grote groep.
Vanuit de groepenlijst of de groepsdetailweergave kun je de volgende acties uitvoeren:
- Maak een groep aan vanuit de lijstweergave door een vereiste naam, een optionele beschrijving en een queryfilter te geven.
- Kloon een bestaande groep uit de lijst- of detailweergave. Klonen is de praktische manier om te beginnen met de definitie van een groep wanneer je aangepaste lidmaatschapscriteria nodig hebt, omdat je het originele filter niet kunt bewerken.
- Bewerk de naam en beschrijving van een groep vanuit de detailweergave. Het zoekfilter blijft onveranderlijk.
- Ververs het gecachte lidmaatschap van een groep in de lijst- of detailweergave, met inachtneming van de ververslimieten zoals beschreven in Gecacht lidmaatschap en vernieuwen.
- Verwijder een groep uit de lijst of detailweergave. Je bevestigt de verwijdering door de groepsnaam in te voeren.
Relatie tot taken en software-updates
Groepen bestaan onafhankelijk van een enkele functionaliteit die ze gebruikt. Een groep is een herbruikbare vlootbeheerbron die je vanuit meerdere plaatsen kunt raadplegen. Bijvoorbeeld, een Job gebruikt een groep als doel voor een standaard software-updatebewerking.
Omdat een groep door meer dan één job of workflow kan worden aangewezen, kan het verwijderen van een groep of het wijzigen van de beschikbaarheid ervan invloed hebben op alles wat ervan afhankelijk is. Plan groepslevenscyclusveranderingen met die afhankelijkheid in gedachten.
Beperkingen en beperkingen voor voorbeeldweergave
De volgende limieten gelden momenteel voor groepen:
- Tot 100 groepen per abonnement.
- Minimaal een interval van één uur tussen handmatige verversingen.
-
ListMemberspaginagrootte van 1.000, zonder filtering of sortering in deze preview.