Tags et actions sur une sélection

Ce que fait un tag

Un tag décrit un endpoint avec une clé et une valeur, par exemple site : Lyon ou rôle : serveur. Les tags servent à trois choses : filtrer la liste du parc, bâtir l'arbre du parc, et agir sur un groupe de machines en une fois.

Les clés appartiennent à votre MSP. Tous vos clients partagent les mêmes clés. Un filtre par tag peut donc traverser plusieurs clients, par exemple pour lister toutes les machines rôle : serveur.

Un tag va sur un endpoint de n'importe quel type : une machine avec un agent, ou un tenant Microsoft 365.

Prérequis

• Le rôle Lecture seule, Technicien, Administrateur ou Administrateur plateforme pour lire les tags. Voir Rôles et droits.
• Le rôle Technicien, Administrateur ou Administrateur plateforme pour poser, changer ou retirer un tag, et pour agir sur une sélection.
• Le rôle Administrateur ou Administrateur plateforme pour changer les niveaux de l'arbre. Voir Parc et arborescence.

Règles d'une clé et d'une valeur

Élément	Règle
Clé	De 1 à 64 caractères. Toujours enregistrée en minuscules. Site et site sont une seule clé. Pas de « : ».
Valeur	De 1 à 128 caractères. La casse est gardée. Une valeur peut contenir « : ».
Comparaison des valeurs	Sans la casse. Lyon et lyon sont la même valeur.
Forme enregistrée	La première forme utilisée dans votre MSP. Après Lyon, une saisie de lyon donne Lyon.
Par endpoint	Une seule valeur par clé, et 20 tags au plus.

Vous ne créez pas une clé dans un écran séparé : une clé naît quand vous posez un tag avec un nouveau nom de clé. Le portail l'écrit alors dans le sélecteur de tag : « Nouvelle clé « rôle » : elle est créée pour tous vos clients. »

Poser ou changer un tag sur un endpoint

1. Ouvrez Parc, puis l'endpoint.
2. Sous le titre de la page, cliquez Ajouter un tag.
3. Dans le champ Clé, choisissez une clé de la liste, ou tapez un nouveau nom de clé.
4. Dans le champ Valeur, choisissez une valeur de la liste, ou tapez une nouvelle valeur.
5. Lisez l'aperçu, sous les deux champs.
6. Cliquez Enregistrer le tag.

Les deux listes se remplissent toutes seules. Les valeurs les plus utilisées viennent en premier.

L'aperçu dit ce que l'enregistrement va faire :

Aperçu	Ce qui se passe
« Ajoute site: Lyon. »	Le tag est nouveau sur cet endpoint.
« Change site de Lyon à Paris. »	L'endpoint a déjà cette clé. La nouvelle valeur remplace l'ancienne.
« site: Lyon est déjà sur cet endpoint. »	Rien ne change.
« « Lyon » existe déjà : le tag utilise cette forme. »	Votre MSP a déjà cette valeur dans une autre casse. Le tag prend la forme déjà enregistrée.

Quand l'endpoint a déjà 20 tags, le portail écrit « 20 tags au plus. Retirez d'abord un tag. »

Lire les tags d'un endpoint

Quand votre arbre a des niveaux, la fiche de l'endpoint range les tags en deux groupes :

• Place dans l'arbre : un élément par clé d'arbre, dans l'ordre des niveaux. Une clé que l'endpoint n'a pas s'affiche (sans clé), par exemple (sans site).
• Autres tags : les tags des clés libres.

Le lien Endpoints avec ces tags ouvre la liste du parc filtrée sur tous les tags de cet endpoint.

Retirer un tag d'un endpoint

1. Ouvrez Parc, puis l'endpoint.
2. Sur le tag à retirer, cliquez le bouton Retirer le tag.

Le tag part tout de suite. Quand la clé est un niveau de l'arbre, l'endpoint quitte son nœud et il entre dans le nœud des endpoints sans cette clé, par exemple (sans site).

Sélectionner des endpoints dans la liste

La barre de sélection sert à agir sur plusieurs endpoints en une fois. Elle n'apparaît que pour le rôle Technicien, Administrateur ou Administrateur plateforme.

1. Ouvrez Parc.
2. Réduisez la liste : choisissez un nœud de l'arbre, ou posez des filtres. Voir Parc et arborescence.
3. Cochez la case d'une ou de plusieurs lignes. La case de l'en-tête coche toutes les lignes affichées.
4. Pour agir sur la liste entière, cliquez Sélectionner les N endpoints de la liste.

La barre donne le nombre d'endpoints et le nombre de clients de la sélection, puis quatre boutons : Modifier les tags, Déplacer vers…, Sauvegarder maintenant et Vider la sélection.

Les deux façons de sélectionner ne sont pas la même chose :

Façon	Ce qui est envoyé	Limite
Lignes cochées	La liste des endpoints cochés.	500 lignes au plus.
Sélectionner les N endpoints de la liste	Le périmètre de la liste : le nœud de l'arbre et les filtres. Le serveur relit les endpoints au moment de l'action.	10 000 endpoints au plus.

Au-delà de 500 lignes cochées, le portail écrit « Vous pouvez cocher 500 lignes au plus. Pour agir sur plus, sélectionnez tous les endpoints de la liste. »

Au-delà de 10 000 endpoints, le portail écrit « La sélection a trop d'endpoints pour cette action. Choisissez un nœud plus petit ou ajoutez un filtre. »

Le filtre Version trop ancienne seulement ne propose pas Sélectionner les N endpoints de la liste : ce filtre n'entre pas dans un périmètre du parc. Cochez les lignes.

Modifier les tags d'une sélection

1. Faites votre sélection dans la liste du parc.
2. Cliquez Modifier les tags.
3. Lisez le nombre d'endpoints et de clients, en haut de la fenêtre.
4. Pour ajouter ou changer un tag : choisissez une clé et une valeur, puis cliquez Ajouter aux changements. Répétez pour un autre tag.
5. Pour retirer un tag : cochez une clé de la liste Retirer un tag.
6. Cliquez Appliquer à N endpoints.

La liste Retirer un tag ne propose que les clés présentes dans la sélection. Chaque ligne donne le nombre d'endpoints concernés, par exemple « Retirer site (sur 4 endpoints sur 12) ». Quand la sélection n'a aucun tag, le portail écrit « Les endpoints sélectionnés n'ont aucun tag. »

Une clé est soit dans les changements, soit dans les retraits. Le portail déplace la clé d'une liste à l'autre tout seul.

Rien n'est écrit avant Appliquer. Le changement est ensuite tout ou rien : si un seul endpoint le refuse, aucun endpoint ne change. Le portail écrit le résultat : « Tags changés sur 12 endpoints : 3 ajoutés ou changés, 2 retirés. »

Chaque changement de tag entre dans le journal d'audit, avec son auteur et son heure.

Déplacer une sélection dans l'arbre

Déplacer vers… change la place d'une sélection dans l'arbre du parc. Le portail pose les valeurs des clés d'arbre que vous choisissez. Il ne touche pas aux clés libres.

1. Faites votre sélection dans la liste du parc.
2. Cliquez Déplacer vers….
3. Pour chaque niveau, choisissez une valeur dans la liste :
   • Garder les valeurs actuelles : ce niveau ne change pas ;
   • une valeur déjà présente dans l'arbre du client ;
   • Autre valeur…, puis tapez la nouvelle valeur ;
   • (sans site), qui porte le nom de la clé du niveau : le tag de ce niveau est retiré.
4. Cliquez Déplacer N endpoints.

Chaque niveau garde les valeurs des endpoints tant que vous ne le changez pas. Déplacer Lyon › serveur vers Paris donne donc Paris › serveur.

Le bouton est grisé dans deux cas, et le portail écrit la cause :

Phrase du portail	Ce qu'il faut faire
« « Déplacer vers… » reste dans un client : la sélection est dans 3 clients. »	Ajoutez le filtre Client, ou choisissez le nœud d'un seul client.
« L'arbre du parc n'a pas de niveau sous le client. Un administrateur du MSP règle les niveaux sur la page Clés de tag. »	Réglez d'abord les niveaux de l'arbre. Voir Parc et arborescence.

Un client n'est pas un tag. Déplacer vers… ne change donc jamais le client d'un endpoint.

Renommer un nœud de l'arbre

Utilisez ce bouton quand une valeur change de nom : une agence renommée, un site déménagé.

1. Ouvrez Parc.
2. Dans l'arbre, choisissez le nœud à renommer. Son dernier niveau doit porter une valeur.
3. En haut de la page, cliquez Renommer ce nœud.
4. Lisez le nombre d'endpoints de la fenêtre.
5. Tapez la nouvelle valeur.
6. Cliquez Renommer sur N endpoints.

La nouvelle valeur va sur chaque endpoint du nœud, aussi sur ceux que les filtres de la liste masquent. Le portail l'écrit dans la fenêtre. Après le renommage, la page suit le nœud sous son nouveau nom.

Un changement de casse seul est refusé. Le portail écrit « Saisissez une autre valeur. Les valeurs se comparent sans la casse : changer seulement la casse ne change rien. »

Le bouton Renommer ce nœud n'apparaît pas sur un nœud sans valeur, par exemple (sans site) : ce nœud n'a pas de valeur à renommer. Il n'apparaît pas non plus sur un nœud de client ni sur Tous les endpoints : ce bouton ne change qu'une valeur de tag.

Sauvegarder une sélection maintenant

Le bouton Sauvegarder maintenant de la barre de sélection lance une sauvegarde hors planning sur chaque machine de la sélection. Choisissez le type Fichiers ou Image système. Une demande démarre 500 sauvegardes au plus.

La procédure complète, la liste des machines ignorées et leurs causes sont dans Sauvegarder maintenant.

Renommer ou supprimer une clé de tag

1. Dans le menu principal, ouvrez le menu Administration.
2. Cliquez Clés de tag.
3. Lisez le tableau Clés : le nom de la clé, son nombre d'endpoints et son Niveau de l'arbre (ou Clé libre).
4. Sur la ligne de la clé, cliquez Renommer ou Supprimer.

Un renommage change le tag sur chaque endpoint qui a cette clé. La clé garde son niveau dans l'arbre. Le nouveau nom doit être en minuscules, sans « : ». Quand le nom est déjà pris, le portail écrit « Cette clé de tag existe déjà. »

Une suppression retire la clé et son tag sur chaque endpoint. La fenêtre de confirmation écrit combien d'endpoints perdent leur tag, par exemple « 12 endpoints ont cette clé. Le tag est retiré de ces endpoints, avec une entrée dans le journal d'audit pour chacun. » Quand la clé est un niveau de l'arbre, elle écrit en plus « Cette clé est le niveau 2 de l'arbre. Les niveaux suivants remontent. »

Limites et précautions

• Une clé appartient au MSP, pas à un client. Un renommage ou une suppression touche donc tous vos clients en une fois.
• Une suppression de clé ne s'annule pas. Les tags retirés ne reviennent pas. Avant de supprimer, vérifiez le nombre d'endpoints de la ligne.
• Un endpoint porte 20 tags au plus. Au-delà, le portail refuse l'écriture, avec « Un endpoint peut avoir 20 tags au plus. »
• Un changement sur une sélection est tout ou rien. Il ne laisse jamais la moitié de la sélection changée.
• Un changement sur une sélection porte 20 tags à ajouter ou à changer au plus, et 20 clés à retirer au plus.
• La sélection est relue au moment de l'action. Quand son nombre a changé entre-temps, rien ne change, et le portail écrit « La liste a changé pendant que cette fenêtre était ouverte. Vérifiez le nouveau nombre, puis confirmez de nouveau. »
• Quand un administrateur change les niveaux de l'arbre pendant que votre fenêtre Déplacer vers… est ouverte, le portail écrit « Cette clé n'est plus un niveau de l'arbre du parc. Ouvrez de nouveau la fenêtre. »
• Le rôle Lecture seule ne voit ni Ajouter un tag, ni la barre de sélection, ni Renommer ce nœud, ni les boutons de la page Clés de tag.
• Un jeton d'enrôlement peut porter des tags. La machine les reçoit une seule fois, à son enrôlement. Ensuite, les tags du jeton et ceux de l'endpoint sont séparés. Voir Jeton d'enrôlement.
• Un endpoint dont la suppression est demandée garde ses tags jusqu'à la fin du délai. À la suppression, ses tags partent avec lui. Voir Supprimer un endpoint ou un client.
• Un assistant IA pose les tags d'un seul endpoint à la fois. Aucun outil MCP n'agit sur plusieurs endpoints, ne renomme une clé, ni ne supprime une clé.

Référence

• API : Fleet, routes GET /tag-keys, POST /tag-keys, PATCH /tag-keys/{id}, DELETE /tag-keys/{id} et GET /tag-keys/{id}/values pour les clés et les valeurs.
• API : Fleet, routes GET /endpoints/{id}/tags, POST /endpoints/{id}/tags et DELETE /endpoints/{id}/tags/{keyId} pour les tags d'un endpoint.
• API : Fleet, routes POST /endpoint-tags pour plusieurs endpoints, POST /fleet/selection pour le résumé d'une sélection, POST /fleet/tags pour les tags d'une sélection, POST /fleet/move pour un déplacement et POST /fleet/backups pour une sauvegarde.
• API : Endpoints, route GET /endpoints et son filtre tag.
• Outils MCP : list_tag_keys pour lire les clés et les valeurs, et set_endpoint_tags pour les tags d'un endpoint.