Attribuez des tags personnalisés aux produits, appareils et groupes afin de catégoriser les ressources partageant des caractéristiques communes. Les tags simplifient la recherche, l'agrégation et la gestion des ressources IoT à grande échelle.
Remarques sur l'utilisation
|
Tag |
Description |
|
tag de produit |
Décrit les attributs partagés par tous les appareils appartenant au même produit. Par exemple, vous pouvez utiliser des tags pour identifier le fabricant d'un produit, son organisation, ses dimensions physiques ou son système d'exploitation. |
|
tag d'appareil |
Identifie un appareil selon une caractéristique spécifique, ce qui vous permet de catégoriser, d'agréger et d'analyser les appareils pour une gestion unifiée. Par exemple, vous pouvez attribuer le tag room:201 à un compteur intelligent situé dans la pièce 201. |
|
tag de groupe |
Décrit les attributs partagés par les appareils et sous-groupes au sein d'un groupe, permettant ainsi la gestion d'appareils inter-produits. Par exemple, vous pouvez taguer la région ou l'espace où se trouvent les appareils d'un groupe. |
Cas d'utilisation
Effectuer des opérations par lot à l'aide de tags
|
Tag |
Exemple d'opération |
|
tag de produit |
Recherchez les produits partageant des attributs communs au sein d'une instance IoT Platform en fonction de leurs tags. |
|
tag d'appareil |
Après avoir recherché les appareils cibles en fonction de leurs tags, vous pouvez effectuer les opérations par lot suivantes :
|
|
tag de groupe |
Recherchez les groupes et sous-groupes partageant des attributs communs au sein d'une instance IoT Platform en fonction de leurs tags. |
Gérer les tags depuis les appareils
Une fois la gestion des tags implémentée sur vos appareils, ceux-ci peuvent effectuer les opérations suivantes :
Signaler des tags : lorsqu'un appareil signale ses tags, IoT Platform ajoute ou met automatiquement à jour les tags d'appareil correspondants dans la console.
Supprimer des tags : un appareil envoie une demande de suppression de ses tags et IoT Platform les supprime upon réception.
Interroger des tags : un appareil envoie une demande d'interrogation de ses tags et IoT Platform renvoie les informations demandées upon réception.
Le SDK Link multilingue côté appareil d'IoT Platform intègre la fonctionnalité de tagging et transmet les informations de tag au sein du système. Pour des exemples de code du SDK Link côté appareil, consultez la rubrique Tags d'appareil pour le développement d'appareils. Pour connaître les topics et les formats de données utilisés pour gérer les tags, consultez la rubrique Protocole Alink pour les tags d'appareil.
Transférer les informations de modification de tag
Grâce au transfert de messages, IoT Platform envoie des messages concernant les opérations sur les tags d'appareil (ajout, mise à jour, suppression et effacement) à votre serveur d'application ou à d'autres services Alibaba Cloud. Pour plus d'informations sur la configuration du transfert de messages, consultez la rubrique Transfert de messages. Pour connaître le format des données transférées, consultez la rubrique Modifications des tags d'appareil.
Prérequis
Vous vous êtes connecté à la console IoT Platform.
-
Avant d'ajouter des tags, créez le produit, l'appareil ou le groupe correspondant. Pour plus d'informations, consultez les rubriques suivantes :
Informations contextuelles
La gestion d'un grand nombre d'appareils IoT nécessite souvent de les différencier et de les traiter par lot. IoT Platform répond à ce besoin grâce à sa fonctionnalité de tagging. Attribuez des tags aux produits, appareils et groupes, puis catégorisez et gérez-les en fonction de ces tags.
Limites
Les tags pour les produits, appareils et groupes sont des paires clé-valeur au format
Key:Value.La clé de tag abc est réservée par IoT Platform. Ne définissez pas une
Keyde tag sur abc. Si vous définissezKey=abc, le tag est automatiquement filtré lors des recherches basées sur les tags.-
Les clés de tag ne sont pas sensibles à la casse. Toutefois, IoT Platform et les données transférées via la fonctionnalité de transfert de messages utilisent toujours la casse d'origine de la
keydu tag.Même si vous supprimez un tag puis le rajoutez en modifiant uniquement la casse, la
keydans les données transférées conserve la casse d'origine.Par exemple, si vous créez un tag
ssid:1000puis le mettez à jour en utilisantSsid:1001, laValueest correctement mise à jour sur 1001, mais les données transférées par le système utilisent toujoursssid:1001. Chaque produit, appareil ou groupe peut comporter au maximum 100 tags.
Modifier les tags dans la console
Modifier les tags de produit
Sur la page Overview, recherchez l'instance que vous souhaitez gérer et cliquez sur son ID ou son nom.
Dans le volet de navigation de gauche, sélectionnez .
-
Sur la page Products, recherchez le produit que vous souhaitez taguer, puis cliquez sur View dans la colonne Actions correspondante.
La section Tag Information affiche tous les tags du produit.
Cliquez sur Edit à droite de Tag Information.
-
Dans la boîte de dialogue Edit Tag, saisissez la Tag Key et la Tag Value.
Cliquez sur Delete pour supprimer un tag existant, ou sur + Add Tag pour en ajouter un nouveau.
Paramètre
Description
clé de tag
Doit contenir entre 1 et 30 caractères et peut inclure des lettres, des chiffres et des points (.).
valeur de tag
Peut contenir jusqu'à 128 caractères et inclure des caractères chinois, japonais, des lettres, des chiffres, des traits de soulignement (_), des tirets (-), des deux-points (:), et des points (.). Chaque caractère chinois ou japonais compte pour deux caractères.
(Facultatif) Cliquez sur Add Tag pour ajouter d'autres tags, ou sur Delete pour supprimer les tags indésirables.
Cliquez sur Confirm.
Modifier les tags d'appareil
Dans le volet de navigation de gauche de l'instance cible, sélectionnez .
-
Sur la page Device, cliquez sur View pour l'appareil que vous souhaitez taguer.
La section Tag Information affiche tous les tags de l'appareil.
Sur la page Device Details, cliquez sur Edit à droite de Tag Information.
-
Dans la boîte de dialogue Edit Tag, cliquez sur Add Tag et saisissez la clé de tag et la valeur de tag.
Paramètre
Description
clé de tag
Doit contenir entre 1 et 30 caractères et peut inclure des lettres, des chiffres, des barres obliques (/), des traits de soulignement (_), des tirets (-), des dièses (#), des arobases (@), des signes pourcentage (%), des esperluettes (&), des astérisques (*) et des points (.).
valeur de tag
Peut contenir jusqu'à 128 caractères et inclure des caractères chinois, japonais, des lettres, des chiffres, des traits de soulignement (_), des tirets (-), des dièses (#), des arobases (@), des signes pourcentage (%), des esperluettes (&), des deux-points (:) et des points (.). Chaque caractère chinois ou japonais compte pour deux caractères.
(Facultatif) Cliquez sur Add Tag pour ajouter d'autres tags, ou sur Delete pour supprimer les tags indésirables.
Cliquez sur Confirm.
Modifier les tags de groupe
Dans le volet de navigation de gauche de l'instance cible, sélectionnez .
-
Sur la page Groups, localisez le groupe auquel vous souhaitez ajouter des tags, puis cliquez sur View dans la colonne Actions correspondante.
La section Group Tags affiche tous les tags du groupe.
Cliquez sur Edit à droite de Tag Information.
-
Dans la boîte de dialogue Edit Tag, saisissez la Tag Key et la Tag Value.
Cliquez sur Delete pour supprimer un tag existant, ou sur + Add Tag pour en ajouter un nouveau.
Paramètre
Description
Clé de tag
Doit comporter entre 1 et 30 caractères et peut contenir des lettres, des chiffres et des points (.).
Valeur de tag
Peut contenir jusqu'à 128 caractères, y compris des caractères chinois, japonais, des lettres, des chiffres, des traits de soulignement (_), des tirets (-), des deux-points (:) et des points (.). Chaque caractère chinois ou japonais compte pour deux caractères.
(Facultatif) Cliquez sur Add Tag pour ajouter d'autres tags, ou sur Delete pour supprimer les tags indésirables.
Cliquez sur OK.
Gérer les tags avec les API côté serveur
IoT Platform fournit des API côté serveur pour gérer les tags par lots et interroger les produits, les appareils et les groupes en fonction de leurs tags.
Tags de produit
|
Fonctionnalité |
API |
Description |
|
Modifier les tags |
Crée des tags de produit. |
|
|
Met à jour les tags de produit. |
||
|
Supprime les tags de produit. |
||
|
Interroger les tags |
Interroge tous les tags d'un produit. |
|
|
Utiliser les tags |
Interroge les produits par tag. |
Tags d'appareil
|
Fonctionnalité |
API |
Description |
|
Modifier les tags |
Définit les tags d'appareil. |
|
|
Supprime les tags d'appareil. |
||
|
Interroger les tags |
Interroge la liste des tags d'un appareil spécifié. |
|
|
Utiliser les tags |
Interroge les appareils par tag. |
Tags de groupe
|
Fonctionnalité |
API |
Description |
|
Modifier les tags |
Ajoute, met à jour ou supprime les tags de groupe. |
|
|
Interroger les tags |
Interroge la liste des tags d'un groupe. |
|
|
Utiliser les tags |
Interroge les groupes d'appareils par tag. |