Koncepcje dotyczące grup (podgląd)

Grupa w Azure Device Registry to zestaw jednorodnych zasobów definiowany przez zapytanie, których używasz do targetowania operacji na skalę floty, takich jak aktualizacje oprogramowania. W obecnym podglądzie grupa jest przeznaczona dla urządzeń połączonych z IoT Hub. Zamiast zarządzać poszczególnymi zasobami, definiujesz filtr raz i ponownie używasz powstałej grupy tam, gdzie musisz działać na tym zestawie zasobów.

Diagram przedstawiający zadanie aktualizacji oprogramowania skierowane do grupy urządzeń oraz zadanie aktualizacji wdrażania skierowane do urządzeń będących wdrażanymi w przestrzeni nazw Azure Device Registry.

Important

Grupy w Azure Device Registry są obecnie w wersji zapoznawczej.

Możliwość stosowania usługi

Feature Operacje Azure IoT Azure IoT Hub
Groups Nie jest obsługiwane w tej zapowiedzi Preview

W tej wersji zapoznawczej grupy obsługują urządzenia połączone z IoT Hub w przestrzeni nazw Azure Device Registry.

Przynależność zdefiniowana przez zapytanie

Tworzysz grupę, definiując filtr względem obsługiwanych właściwości zasobów, takich jak producent lub wersja oprogramowania. W podglądzie jedynym obsługiwanym typem zasobu platformy Azure jest RegistryDevice. Azure Device Registry ocenia filtr w przestrzeni nazw i wypełnia grupę wszystkimi pasującymi zasobami.

Dla RegistryDevice grup używaj nazw właściwości w języku zapytań w definicji zapytania. Przykład:

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

Urządzenie może należeć do więcej niż jednej grupy jednocześnie. Na przykład urządzenie może pasować zarówno do grupy "firmware version 2.1", jak i do grupy "building 12". Członkostwo nie jest wyłączne, więc możesz tworzyć grupy wokół różnych potrzeb operacyjnych bez powielania urządzeń.

Obsługiwane właściwości i operatory RegistryDevice

Poniższa tabela przedstawia obsługiwane właściwości i operatory w zapytaniach filtru RegistryDevice:

Terminologia użytkownika Ścieżka właściwości Typ literału Operators
Przestrzeń nazw UUID namespaceUuid ciąg =, !=, <>
nazwa name ciąg =, !=, , <>, INNIN
typ zasobu resourceType ciąg =, !=, <>
lokalizacja location ciąg =, !=, , <>, INNIN
UUID urządzenia uuid ciąg =, !=, , <>, INNIN
stan inicjowania obsługi provisioningState ciąg =, !=, , <>, INNIN
Zewnętrzny identyfikator urządzenia externalDeviceId ciąg =, !=, , <>, INNIN
włączone, wyłączone enabled wyliczenie tekstowe =, !=, <>; wartości to 'Enabled' i 'Disabled'
producent manufacturer ciąg =, !=, <>
model model ciąg =, !=, <>
Rewizja oprogramowania softwareRevision ciąg =, !=, <>
klucz tagu tags.<key> ciąg =, !=, <>; maksymalna głębokość ścieżki wynosi 4

Obsługiwane właściwości i operatory aktualizacji urządzenia RegistryDevice

Poniższa tabela przedstawia obsługiwane właściwości i operatory zapytań RegistryDevice filtrujących w ramach zakresu attributes.update :

Ścieżka właściwości Typ literału Operators
attributes.update.deviceClassId ciąg =, !=, , <>, INNIN
attributes.update.installedUpdateId.provider ciąg =, !=, , <>, INNIN
attributes.update.installedUpdateId.name ciąg =, !=, , <>, INNIN
attributes.update.installedUpdateId.version ciąg =, !=, , <>, INNIN
attributes.update.latestUpdateJobInfo.state ciąg =, !=, , <>, INNIN
attributes.update.latestUpdateJobInfo.updateId.provider ciąg =, !=, , <>, INNIN
attributes.update.latestUpdateJobInfo.updateId.name ciąg =, !=, , <>, INNIN
attributes.update.latestUpdateJobInfo.updateId.version ciąg =, !=, , <>, INNIN
attributes.update.agentInfo.compatibilityProperties.<key> ciąg =, !=, <>; maksymalna głębokość ścieżki wynosi 5
attributes.update.agentInfo.agentProfile liczba całkowita =, !=, , <>, INNIN

Można łączyć warunki z AND, OR, NOT, nawiasami i porównaniami do null. Funkcje skalarne takie jak STARTSWITH, CONTAINS, IS_NULL i IS_DEFINED, porównania pola do pola oraz dowolne ścieżki properties.* lub attributes.* nie są obsługiwane.

Członkostwo z pamięci podręcznej i odświeżanie

Przynależność do grupy jest obliczana i buforowana w czasie odświeżania — nie jest oceniana w czasie rzeczywistym. Gdy tworzysz grupę lub odświeżasz istniejącą, Azure Device Registry ponownie ocenia filtr i aktualizuje listę członków w pamięci podręcznej.

Wywołujesz odświeżanie grupy przez operację RefreshMembers . Odświeżanie jest asynchroniczne, a grupa może mieć Creating, RefreshingMembers, lub Ready status. Możesz wyświetlać członków, gdy grupa osiągnie status Ready.

Ponieważ członkostwo jest buforowane, lista członków grupy może być nieaktualna między odświeżeniami. Jeśli właściwości zasobu ulegną zmianie lub nowy zasób zacznie odpowiadać filtrowi, ta zmiana nie jest odzwierciedlona na liście członków grupy z ręcznym odświeżaniem, dopóki nie zakończy się kolejne odświeżenie. Usługa wymaga minimalnej godzinnej przerwy między ręcznymi odświeżeniami.

Filtry niezmienne i cykl życia

Możesz edytować nazwę i opis grupy. Filtr jest ustalony przy tworzeniu; aby celować w inny zestaw urządzeń, utwórz lub sklonuj grupę z nowym filtrem.

Aby wybrać inny lub zmodyfikowany zestaw zasobów, stwórz osobną grupę z nowym filtrem. Usunięcie grupy usuwa tylko grupę; jej urządzenia członkowskie pozostają.

Zarządzaj grupami w portalu Azure (wersja zapoznawcza)

W tym podglądzie strona Grupy (podgląd) w nawigacji przestrzeni nazw wymienia Twoje grupy i otwiera widok szczegółów grup. Widok szczegółowy pokazuje podstawy grupy, definicję filtra zapytań tylko do odczytu oraz aktualną liczbę członków i czas ostatniej aktualizacji. Ponieważ filtr jest ustawiony przy tworzeniu i nie można go edytować, użyj widoku szczegółów, aby potwierdzić, na które urządzenia celuje dana grupa. Lista członków wyświetla podgląd maksymalnie 10 urządzeń, więc traktuj ją jako wyrywkową kontrolę, a nie jako pełną listę dużej grupy.

Z listy grup lub widoku szczegółów grup możesz wykonać następujące działania:

  • Utwórz grupę w widoku listy, podając wymaganą nazwę, opcjonalny opis oraz filtr zapytania.
  • Sklonuj istniejącą grupę z widoku listy lub szczegółów. Klonowanie to praktyczny sposób, aby zacząć od definicji grupy, gdy trzeba dostosować kryteria członkostwa, ponieważ nie można edytować oryginalnego filtra.
  • Edytuj nazwę i opis grupy w widoku szczegółów. Filtr zapytań pozostaje niezmienny.
  • Odśwież członkostwo grupy w pamięci podręcznej w widoku listy lub szczegółów, z zastrzeżeniem limitów odświeżania opisanych w Członkostwo w pamięci podręcznej i odświeżanie.
  • Usuń grupę z listy lub widoku szczegółów. Potwierdzasz usunięcie, wpisując nazwę grupy.

Związek z zadaniami i aktualizacjami oprogramowania

Grupy istnieją niezależnie od pojedynczej zdolności, która z nich korzysta. Grupa to zasób do wielokrotnego użytku służący do zarządzania flotą, do której możesz odwoływać się z wielu miejsc. Na przykład Job używa grupy jako celu dla standardowej operacji aktualizacji oprogramowania.

Ponieważ grupa może być odwołana przez więcej niż jedno zadanie lub przepływ pracy, usunięcie grupy lub zmiana jej dostępności może wpłynąć na wszystko, co od niej zależy. Planuj zmiany cyklu życia grupy, mając na uwadze tę zależność.

Limity i ograniczenia podglądowe

Obecnie dla grup obowiązują następujące ograniczenia:

  • Do 100 grup w ramach subskrypcji.
  • Minimalna godzinna przerwa między ręcznymi odświeżeniami.
  • ListMembers Rozmiar strony wynosi 1 000, bez filtrowania ani sortowania w tym podglądzie.

Treści powiązane

  • Ostatnia aktualizacja o