Merge pull request #8391 from ovh/dev/gbarideau/iam-tag-manager

New guide for Tag Management

Author: Y0Coss

pages/index.md

@@ -2095,6 +2095,7 @@
         + [How to use IAM policies using the OVHcloud API](account_and_service_management/account_information/iam-policies-api)
         + [How to use IAM policies using the OVHcloud Control Panel](account_and_service_management/account_information/iam-policy-ui)
         + [List of permission groups managed by OVHcloud](account_and_service_management/account_information/iam-permission-groups)
+        + [How to manage tags on resources](manage_and_operate/iam/iam-tag-manager)
         + [How to create an IAM policy to allow a user to log to the OVHcloud Control Panel](account_and_service_management/account_information/iam-control-panel-access)
         + [How to use IAM policies with vSphere](hosted_private_cloud/hosted_private_cloud_powered_by_vmware/use_iam_with_vSphere)
         + [Authenticate on Openstack API with service account](manage_and_operate/iam/authenticate-api-openstack-with-service-account)

pages/manage_and_operate/iam/iam-tag-manager/guide.en-gb.md

@@ -0,0 +1,124 @@
+---
+title: "How to manage tags on resources"
+excerpt: "Find out how to manage and use tags on your OVHcloud resources"
+updated: 2025-09-15
+---
+
+## Objective
+
+In this guide, you will learn how to assign and manage tags on your OVHcloud products and how to use them in IAM policies.
+
+## Requirements
+
+- An [OVHcloud customer account](/pages/account_and_service_management/account_information/ovhcloud-account-creation).
+
+## Instructions
+
+### Managing Tags via the Control Panel
+
+You can manage your OVHcloud product tags either through the general tag management interface or through dedicated interfaces within the products.
+
+Tags are metadata in the form of key-value pairs added to OVHcloud resources, which can be used in IAM policies or for resource categorization.
+
+#### Tag Manager
+
+**Tag Manager** is the interface that allows you to manage your tags across all your OVHcloud products in a transverse manner.
+
+To access it, go to the `Identity, Security & Operations`{.action} menu, then click `Tag Management`{.action} under the `Identity and Access Management` section.
+
+The page displays all the tags currently placed on your resources.
+
+![Tag Manager](images/tag-manager-01.png){.thumbnail}
+
+For each tag, the dashboard shows the number of resources associated with this tag and the type of tag.
+
+There are three types of tags:
+
+- Custom: Created and managed by you.
+- Predefined: Created by OVHcloud, you are responsible for assigning this type of tag to your resources.
+- System: Created and automatically assigned by OVHcloud to your resources (cannot be deleted).
+
+Unassigned predefined tags and system tags do not appear by default and must be displayed via the `Quick filters`{.action} button.
+
+By clicking on the tag, you can access the tag details with the list of concerned resources.
+
+![Tag Manager](images/tag-manager-02.png){.thumbnail}
+
+It is then possible to assign this tag to other resources via the `Assign tag`{.action} button. The list of all resources in the account is then displayed, allowing multiple selections.
+
+A filter field is present on the right to facilitate searching for resources.
+
+On the contrary, by selecting resources in the tag details, it is possible to remove the tag from them via the `Unassign Tag`{.action} button.
+
+#### Product dashboard
+
+For some OVHcloud products, an interface has been added to manage tags directly from the resource management dashboard.
+
+![Tag Manager](images/baremetal-tag-01.png){.thumbnail}
+
+The tag management interface allows you to add or remove tags from the resource.
+
+![Tag Manager](images/baremetal-tag-02.png){.thumbnail}
+
+It is possible to either select one or more tags from the list of predefined tags or enter your own tags by typing the keys and values directly into the fields.
+
+### Managing Tags via API
+
+Tag management is centralized in a single API for all OVHcloud products:
+
+| **Method** |               **Path**                |       **Description**        |
+| :--------: | :-----------------------------------: | :--------------------------: |
+|    POST    |    /iam/resource/{resourceURN}/tag    |   Add a tag to a resource    |
+|    DEL     | /iam/resource/{resourceURN}/tag/{key} | Remove a tag from a resource |
+
+The tag must be specified in the following format:
+
+```json
+{
+  "key": "environment",
+  "value": "production"
+}
+```
+
+### Using Tags in IAM Policies
+
+Tags can be used as conditions in IAM policies using the `resource.Tag(tag_key)` condition.
+
+For example, the following policy grants rights to all VPS with the tag `Environment:Production`:
+
+```json
+{
+  "conditions": {
+    "conditions": [
+      {
+        "operator": "MATCH",
+        "values": {
+          "resource.Tag(Environment)": "Production"
+        }
+      }
+    ],
+    "operator": "AND"
+  },
+  "description": "Give access to VPS with tag Environment:Production",
+  "identities": [
+    "urn:v1:eu:identity:group:aa1-ovh/devs"
+  ],
+  "name": "vps-production",
+  "permissions": {
+    "allow": [
+      {
+        "action": "vps:apiovh:*"
+      }
+    ]
+  },
+  "resources": [
+    {
+      "urn": "urn:v1:eu:resource:vps:*"
+    }
+  ]
+}
+```
+
+## Go further
+
+Join our [community of users](/links/community).

pages/manage_and_operate/iam/iam-tag-manager/guide.fr-fr.md

@@ -0,0 +1,124 @@
+---
+title: "Comment utiliser les tags sur vos ressources"
+excerpt: "Découvrez comment gérer et utiliser les tags sur vos ressources OVHcloud"
+updated: 2025-09-15
+---
+
+## Objectif
+
+Dans ce guide, vous apprendrez à affecter et gérer des tags sur vos produits OVHcloud et comment les utiliser dans les politiques IAM.
+
+## Prérequis
+
+- Disposer d'un [compte client OVHcloud](/pages/account_and_service_management/account_information/ovhcloud-account-creation).
+
+## En pratique
+
+### Gérer les tags via l'espace client
+
+Il est possible de gérer les tags de vos produits OVHcloud soit a travers l'interface générale de gestion des tag, soit à travers les interfaces dédiées dans les produits.
+
+Les tags sont des métadonnées sous forme de clé/valeur ajoutées aux ressources OVHcloud, qui peuvent être utilisées dans les politiques IAM ou la catégorisation des ressources.
+
+#### Tag Manager
+
+**Tag Manager** est l'interface qui vous permet de gérer vos tags sur l'ensemble de vos produits OVHcloud.
+
+Pour y accéder, rendez-vous dans le menu `Identité, Sécurité & Opérations`{.action} puis cliquez sur `Tag Management`{.action} sous la section `Gestion des identités et des accès`.
+
+Vous retrouverez sur cette page l'ensemble des tags actuellement placés sur vos ressources.
+
+![Tag Manager](images/tag-manager-01.png){.thumbnail}
+
+Pour chaque tag, le tableau de bord indique le nombre de ressources associées ainsi que le type de tag.
+
+Il existe 3 types de tags :
+
+- Custom : Créé et géré par vos soins.
+- Prédéfini : Créé par OVHcloud, il vous appartient d'assigner ce type de tag à vos ressources.
+- Système : Créé et assigné automatiquement par OVHcloud à vos ressources (les tags de ce type ne peuvent pas être supprimés).
+
+Les tags prédéfinis non assignés et les tags système ne n'apparaissent pas par défaut et doivent être affichés via le bouton `Filtres rapides`{.action}.
+
+En cliquant sur un tag, on accède aux détails du tag avec la liste des ressources concernées.
+
+![Tag Manager](images/tag-manager-02.png){.thumbnail}
+
+Il est ensuite possible d'assigner ce tag à d'autres ressources via le bouton `Assigner le tags`{.action}. La liste de l'ensemble des ressources du compte s'affiche alors, permettant plusieurs sélections.
+
+Un champ de filtre est présent à droite pour faciliter la recherche dans les ressources.
+
+A l'inverse, en sélectionnant les ressources dans les détails du tag, il est possible de supprimer le tag de celles-ci via le bouton `Désassigner le tag`{.action}.
+
+#### Tableau de bord du produit
+
+Pour certains produits OVHcloud, une interface a été ajoutée pour gérer les tags directement depuis le tableau de bord de gestion des ressources.
+
+![Tag Manager](images/baremetal-tag-01.png){.thumbnail}
+
+L'interface de gestion de tags permet d'ajouter ou retirer des tags sur la ressource.
+
+![Tag Manager](images/baremetal-tag-02.png){.thumbnail}
+
+Il est possible de sélectionner un ou plusieurs tags dans la liste des tags prédéfinis ou d'entrer vos propres tags en saisissant directement les clés et les valeurs dans les champs.
+
+### Gestion des tags via l'API
+
+La gestion des tags est centralisée dans une API unique pour tous les produits OVHcloud :
+
+| **Méthode** |              **Chemin**               |            **Description**             |
+| :---------: | :-----------------------------------: | :------------------------------------: |
+|    POST     |    /iam/resource/{resourceURN}/tag    |    Ajout d'un tag sur une ressource    |
+|     DEL     | /iam/resource/{resourceURN}/tag/{key} | Suppression d'un tag sur une ressource |
+
+Le tag doit être indiqué sous cette forme :
+
+```json
+{
+  "key": "environment",
+  "value": "production"
+}
+```
+
+### Utilisation dans les politiques IAM
+
+Les tags peuvent être utilisés comme conditions dans les politiques IAM grâce à la condition `resource.Tag(tag_key)`.
+
+Par exemple, la politique suivante accorde des droits à tous les VPS portant le tag `Environment:Production` :
+
+```json
+{
+  "conditions": {
+    "conditions": [
+      {
+        "operator": "MATCH",
+        "values": {
+          "resource.Tag(Environment)": "Production"
+        }
+      }
+    ],
+    "operator": "AND"
+  },
+  "description": "Give access to VPS with tag Environment:Production",
+  "identities": [
+    "urn:v1:eu:identity:group:aa1-ovh/devs"
+  ],
+  "name": "vps-production",
+  "permissions": {
+    "allow": [
+      {
+        "action": "vps:apiovh:*"
+      }
+    ]
+  },
+  "resources": [
+    {
+      "urn": "urn:v1:eu:resource:vps:*"
+    }
+  ]
+}
+```
+
+## Aller plus loin
+
+Échangez avec notre [communauté d'utilisateurs](/links/community).

pages/manage_and_operate/iam/iam-tag-manager/images/baremetal-tag-01.png

@@ -0,0 +1,3 @@
+id: 6c541404-ca56-4a83-960b-33523bcf66d2
+full_slug: iam-tag-manager
+reference_category: manage-operate-iam