Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Un groupe dans Azure Device Registry est un ensemble défini par requête de ressources homogènes que vous utilisez pour cibler des opérations à l’échelle de la flotte, telles que les mises à jour logicielles. Dans l’aperçu actuel, un groupe cible les appareils connectés à l’IoT Hub. Au lieu de gérer les ressources individuelles, vous définissez un filtre une fois et réutilisez le groupe résultant là où vous devez agir sur cet ensemble de ressources.
Important
Les groupes Azure Device Registry sont actuellement en aperçu.
Applicabilité du service
| Fonctionnalité | Opérations Azure IoT | Azure IoT Hub |
|---|---|---|
| Groups | Non pris en charge dans cette version préliminaire | Preview |
Dans cette version préliminaire, les groupes prennent en charge les appareils connectés à IoT Hub dans un espace de noms Registre de Dispositifs Azure.
Appartenance définie par requête
Vous créez un groupe en définissant un filtre pour les propriétés des ressources prises en charge, telles que le fabricant ou la révision logicielle. Dans l’aperçu, le seul type de ressource Azure pris en charge est RegistryDevice. Azure Device Registry évalue le filtre dans l’espace de noms et remplit le groupe avec chaque ressource correspondante.
Pour les RegistryDevice groupes, utilisez les noms des propriétés du langage de requête dans la définition de la requête. Par exemple:
WHERE manufacturer = 'Contoso' AND model = 'Sensor-v2'
Un appareil peut appartenir à plusieurs groupes en même temps. Par exemple, un appareil peut correspondre à la fois à un groupe « firmware version 2.1 » et un groupe « building 12 ». L’adhésion n’est pas exclusive, vous pouvez donc composer des groupes selon différents besoins opérationnels sans dupliquer les appareils.
Propriétés et opérateurs pris en charge par RegistryDevice
Le tableau suivant présente les propriétés et opérateurs supportés pour les requêtes de filtre RegistryDevice :
| Terminologie utilisateur | Chemin d’accès à la propriété | Type littéral | Operators |
|---|---|---|---|
| UUID de l'espace de noms | namespaceUuid |
string |
=, !=, <> |
| nom | name |
string |
=, !=, <>, IN, NIN |
| type de ressource | resourceType |
string |
=, !=, <> |
| location | location |
string |
=, !=, <>, IN, NIN |
| UUID de l’appareil | uuid |
string |
=, !=, <>, IN, NIN |
| État de provisionnement | provisioningState |
string |
=, !=, <>, IN, NIN |
| ID de périphérique externe | externalDeviceId |
string |
=, !=, <>, IN, NIN |
| activé, désactivé | enabled |
énumération de chaînes |
=, !=, <>; les valeurs sont 'Enabled' et 'Disabled' |
| manufacturer | manufacturer |
string |
=, !=, <> |
| model | model |
string |
=, !=, <> |
| Révision logicielle | softwareRevision |
string |
=, !=, <> |
| Clé de balise | tags.<key> |
string |
=, !=, <>; la profondeur maximale du chemin est de 4 |
Propriétés et opérateurs de mise à jour pris en charge par RegistryDevice
Le tableau suivant présente les propriétés et opérateurs supportés pour les requêtes de filtre RegistryDevice dans la portée attributes.update :
| Chemin d’accès à la propriété | Type littéral | Operators |
|---|---|---|
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 |
=, !=, <>; la profondeur maximale du chemin est de 5 |
attributes.update.agentInfo.agentProfile |
integer |
=, !=, <>, IN, NIN |
Vous pouvez combiner des conditions avec AND, OR, NOT, des parenthèses et des comparaisons avec null. Les fonctions scalaires telles que STARTSWITH, CONTAINS, IS_NULL et IS_DEFINED, les comparaisons champ à champ, ainsi que les chemins properties.* ou attributes.* arbitraires ne sont pas pris en charge.
Appartenance mise en cache et actualisation
L’appartenance au groupe est calculée et mise en cache au moment du rafraîchissement — elle n’est pas évaluée en temps réel. Lorsque vous créez un groupe, ou lorsque vous rafraîchissez un groupe existant, Azure Device Registry réévalue le filtre et met à jour la liste des membres mise en cache.
Vous déclenchez un rafraîchissement de groupe à travers l’opération RefreshMembers . Le rafraîchissement est asynchrone, et un groupe peut avoir les statuts Creating, RefreshingMembers ou Ready. Vous pouvez répertorier les membres une fois que le groupe a atteint l'état Ready.
Étant donné que l'appartenance est mise en cache, la liste des membres d'un groupe peut être obsolète entre deux actualisations. Si les propriétés d’une ressource changent, ou si une nouvelle ressource commence à correspondre au filtre, ce changement n’est pas reflété dans la liste des membres d’un groupe à rafraîchissement manuel avant la fin du prochain rafraîchissement. Le service impose un intervalle minimum d’une heure entre les rafraîchissements manuels.
Filtres immuables et cycle de vie
Vous pouvez modifier le nom et la description d’un groupe. Le filtre est fixe lors de la création ; pour cibler un ensemble différent d’appareils, créer ou cloner un groupe avec un nouveau filtre.
Pour cibler un ensemble de ressources différent ou ajusté, créez un groupe séparé avec le nouveau filtre. Supprimer un groupe ne supprime que le groupe ; ses appareils membres restent.
Gérer les groupes dans le portail Azure (aperçu)
Dans cet aperçu, la page Groupes (aperçu) dans la navigation dans l’espace de noms liste vos groupes et ouvre une vue détaillée de groupe. La vue détaillée affiche les éléments essentiels du groupe, une définition du filtre de requête en lecture seule, ainsi que le nombre actuel de membres et l’heure de la dernière mise à jour. Comme le filtre est défini à la création et ne peut pas être modifié, utilisez la vue détaillée pour confirmer quels appareils un groupe cible. La liste des membres présente jusqu’à 10 appareils, donc considérez-la comme un contrôle ponctuel plutôt que comme une liste complète d’un grand groupe.
Depuis la liste des groupes ou la vue détail du groupe, vous pouvez effectuer les actions suivantes :
- Créez un groupe à partir de la vue de liste en fournissant un nom requis, une description optionnelle et un filtre de requête.
- Clonez un groupe existant depuis la liste ou la vue détail. Le clonage est la façon pratique de partir de la définition d’un groupe lorsque vous avez besoin d’ajuster les critères d’adhésion, car vous ne pouvez pas modifier le filtre original.
- Modifie le nom et la description d’un groupe depuis la vue détaillée. Le filtre de requête reste immuable.
- Actualisez l’appartenance mise en cache d’un groupe dans la vue liste ou détail, sous réserve des limites de rafraîchissement décrites dans Appartenance mise en cache et actualisation.
- Supprimez un groupe de la liste ou de la vue détails. Vous confirmez la suppression en entrant le nom du groupe.
Établissement de relations avec les travaux et les mises à jour logicielles
Les groupes existent indépendamment de toute fonctionnalité particulière qui les utilise. Un groupe est une ressource réutilisable de gestion de flotte à laquelle vous pouvez faire référence depuis plusieurs endroits. Par exemple, un Job utilise un groupe comme cible pour une opération standard de mise à jour logicielle.
Parce qu’un groupe peut être référencé par plusieurs tâches ou workflows, supprimer un groupe ou modifier sa disponibilité peut affecter tout ce qui en dépend. Planifiez les changements du cycle de vie du groupe en tenant compte de cette dépendance.
Limites et restrictions d’aperçu
Les limites suivantes s’appliquent actuellement aux groupes :
- Jusqu’à 100 groupes par abonnement.
- Un intervalle minimum d’une heure entre les rafraîchissements manuels.
-
ListMembersTaille de page de 1 000, sans filtrage ni tri dans cet aperçu.