Documentation Oracle Cloud Infrastructure

Balises de ressource

Lorsque vous disposez de nombreuses ressources (par exemple, des instances, des réseaux cloud virtuels, des équilibreurs de charge et des volumes de blocs) dans plusieurs compartiments de votre location, il peut être difficile de suivre les ressources utilisées à des fins spécifiques ainsi que de les agréger, de générer des rapports associés ou de réaliser des actions globales sur celles-ci. Le balisage permet de définir des clés et des valeurs, et de les associer à des ressources. Vous pouvez ensuite utiliser les balises pour organiser et répertorier les ressources en fonction des besoins de votre entreprise.

Il existe deux types de balise :

Les balises définies sont configurées dans votre location par un administrateur. Seuls les utilisateurs autorisés à utiliser les balises définies peuvent les appliquer aux ressources.

Les balises à format libre peuvent être appliquées par n'importe quel utilisateur disposant des droits d'accès sur la ressource.

Pour obtenir des informations détaillées sur les balises et leurs fonctionnalités, reportez-vous à Présentation de Tagging.

Conseil

Regardez une vidéo qui présente les concepts et les fonctionnalités du balisage : Introduction à Tagging.
Attention

Évitez de saisir des informations confidentielles lors de l'affectation de descriptions, de balises ou de noms amicaux à vos ressources cloud via la console, l'API ou la CLI Oracle Cloud Infrastructure.

Utilisation des balises de ressource

Pour ajouter en masse des balises définies

Ajout de plusieurs balises définies aux ressources existantes. Pour appliquer des balises définies, vous devez disposer des droits d'accès nécessaires pour utiliser l'espace de noms.

  1. Ouvrez le menu de navigation. Sous Gouvernance et administration, accédez à Gouvernance et cliquez sur Explorateur de location.

  2. Sélectionnez les ressources auxquelles ajouter les balises. Vous pouvez éventuellement utiliser le menu déroulant Filtrer par type de ressource pour affiner la liste des ressources.

  3. Dans le menu Actions, cliquez sur Gérer les balises.

    La page Gérer les balises s'ouvre. La première table affiche les balises actuellement appliquées aux ressources sélectionnées. La seconde table affiche les ressources sélectionnées.

  4. Sous la liste des balises existantes, cliquez sur + Ajouter un nouveau.
    1. Sélectionnez l'espace de noms de balise.
    2. Sélectionnez la clé de balise.
    3. Pour Valeur, entrez une valeur.
  5. Pour appliquer une autre balise, répétez l'étape précédente. Pour enlever une ligne, cliquez sur le bouton Enlever (x).

  6. Une fois toutes les balises ajoutées, cliquez sur Suivant.

    Une page de confirmation s'ouvre et répertorie les actions à entreprendre et les ressources auxquelles les actions s'appliquent.

  7. Cliquez sur Soumettre.

La page Demande de travail s'ouvre pour vous montrer le statut de la demande de travail pour ajouter des balises aux ressources.

Pour ajouter des balises définies à une ressource existante

Pour appliquer une balise définie, vous devez être autorisé à utiliser l'espace de noms.

  1. Ouvrez la console, puis accédez à la page de détails de la ressource à baliser.

    Par exemple, pour baliser une instance de calcul, ouvrez le menu de navigation. Sous Infrastructure de base, accédez à Compute et cliquez sur Instances. La liste des instances dans le compartiment en cours apparaît. Recherchez l'instance à baliser et cliquez sur son nom pour afficher la page de détails correspondante.

  2. Cliquez sur Appliquer des balises. En fonction de la ressource, cette option peut apparaître dans le menu Actions supplémentaires.

  3. Dans la boîte de dialogue Appliquer des balises à la ressource, procédez comme suit :

    1. Sélectionnez l'espace de noms de balise.
    2. Sélectionnez la clé de balise.
    3. Dans Valeur, entrez une valeur ou sélectionnez-en une dans la liste.
    4. Pour appliquer une autre balise, cliquez sur + Balise supplémentaire.
    5. Une fois les balises ajoutées, cliquez sur Appliquer des balises.
Procédure d'ajout d'une balise à format libre à une ressource existante

  1. Ouvrez la console, puis accédez à la page de détails de la ressource à baliser.

    Par exemple, pour baliser une instance de calcul, ouvrez le menu de navigation. Sous Infrastructure de base, accédez à Compute et cliquez sur Instances. La liste des instances dans le compartiment en cours apparaît. Recherchez l'instance à baliser et cliquez sur son nom pour afficher la page de détails correspondante.

  2. Cliquez sur Appliquer des balises. En fonction de la ressource, cette option peut apparaître dans le menu Actions supplémentaires.

  3. Dans la boîte de dialogue Appliquer des balises à la ressource, procédez comme suit :

    1. Sélectionnez Aucun (appliquer une balise à format libre).
    2. Entrez la clé de balise.
    3. Entrez une valeur.
    4. Pour appliquer une autre balise, cliquez sur + Balise supplémentaire.
    5. Une fois les balises ajoutées, cliquez sur Appliquer des balises.
Procédure d'ajout d'une balise lors de la création d'une ressource

Vous pouvez appliquer des balises lors de la création d'une ressource. L'emplacement de l'option Appliquer des balises dans la boîte de dialogue varie en fonction des ressources. Voici la procédure générale :

  1. Dans la boîte de dialogue de création de la ressource, cliquez sur Appliquer des balises.

    Pour certaines ressources, vous devez cliquer sur Afficher les options avancées afin d'appliquer une balise.

  2. Dans la boîte de dialogue Appliquer des balises à la ressource, procédez comme suit :

    1. Sélectionnez l'espace de noms de balise, ou sélectionnez Aucun pour appliquer une balise à format libre.
    2. Sélectionnez ou saisissez la clé de balise.
    3. Dans Valeur, entrez une valeur ou sélectionnez-en une dans la liste.
    4. Pour appliquer une autre balise, cliquez sur + Balise supplémentaire.
    5. Cliquez sur Appliquer des balises.
Procédure de filtrage de la liste des ressources en fonction d'une balise

Ouvrez la console, cliquez sur le nom de service, puis sur la ressource à afficher. La partie gauche de la page affiche tous les filtres appliqués à la liste.

Par exemple, pour afficher la liste des instances de calcul dans le compartiment en cours, cliquez sur Compute, puis sur Instances.

Procédure de filtrage de la liste des ressources en fonction d'une balise définie
  1. En regard de Filtres de balise, cliquez sur Ajouter.
  2. Dans la boîte de dialogue Appliquer un filtre de balise, saisissez les informations suivantes :
    1. Espace de noms : sélectionnez l'espace de noms de balise.
    2. Clé : sélectionnez une clé spécifique.
    3. Valeur : faites votre choix parmi les options suivantes :
      • Correspondre à l'une des valeurs : renvoie toutes les ressources balisées avec l'espace de noms et la clé sélectionnés, quelle que soit la valeur de balise.
      • Correspondre à l'un des éléments suivants : renvoie les ressources dotées de la valeur de balise saisie dans la zone de texte. Entrez une valeur unique dans la zone de texte. Afin d'indiquer plusieurs valeurs pour le même espace de noms et la même clé, cliquez sur + en vue d'afficher une autre zone de texte. Saisissez une valeur par zone de texte.
    4. Cliquez sur Appliquer un filtre.
Procédure de filtrage de la liste des ressources en fonction d'une balise à format libre
  1. En regard de Filtres de balise, cliquez sur Ajouter.
  2. Dans la boîte de dialogue Appliquer un filtre de balise, saisissez les informations suivantes :
    1. Clé : entrez la clé de balise.
    2. Valeur : faites votre choix parmi les options suivantes :
      • Correspondre à l'une des valeurs : renvoie toutes les ressources balisées avec la clé de balise à format libre sélectionnée, quelle que soit la valeur de balise.
      • Correspondre à l'un des éléments suivants : renvoie les ressources dotées de la valeur de balise saisie dans la zone de texte. Entrez une valeur unique dans la zone de texte. Afin d'indiquer plusieurs valeurs pour la même clé, cliquez sur + en vue d'afficher une autre zone de texte. Saisissez une valeur par zone de texte.
    3. Cliquez sur Appliquer un filtre.
Pour mettre à jour globalement les balises définies

Mise à jour des balises définies appliquées à des ressources.

  1. Ouvrez le menu de navigation. Sous Gouvernance et administration, accédez à Gouvernance et cliquez sur Explorateur de location.

  2. Sélectionnez les ressources dont vous souhaitez mettre à jour les balises. Vous pouvez éventuellement utiliser le menu déroulant Filtrer par type de ressource pour affiner la liste des ressources.

  3. Dans le menu Actions, cliquez sur Gérer les balises.

    La page Gérer les balises s'ouvre. La première table affiche les balises actuellement appliquées aux ressources sélectionnées. La seconde table affiche les ressources sélectionnées.

  4. Dans la liste des balises, trouvez la balise à mettre à jour et entrez une nouvelle valeur. Pour rétablir la modification, cliquez sur le bouton Annuler.
  5. Pour Action, sélectionnez Appliquer la balise à toutes les ressources sélectionnées.

  6. Si vous le souhaitez, mettez à jour d'autres valeurs de balise. Cliquez ensuite sur Suivant.

    Une page de confirmation s'ouvre et répertorie les actions à entreprendre et les ressources auxquelles les actions s'appliquent.

  7. Cliquez sur Soumettre.

La page Demande de travail s'ouvre pour vous montrer le statut de la demande de travail pour mettre à jour les balises sur les ressources.

Pour mettre à jour une balise appliquée à une seule ressource

  1. Ouvrez la console, cliquez sur le nom de service, puis sur la ressource à afficher.

    Par exemple, pour afficher les instances de calcul, ouvrez le menu de navigation. Sous Infrastructure de base, accédez à Compute et cliquez sur Instances. La liste des instances dans le compartiment en cours apparaît. Recherchez l'instance à mettre à jour, puis cliquez sur son nom pour afficher la page de détails correspondante.

  2. Cliquez sur Balises.

    La liste des balises appliquées à la ressource apparaît.

  3. Recherchez la balise à mettre à jour et cliquez sur l'icône en forme de crayon en regard de celle-ci.
  4. Entrez ou sélectionnez une nouvelle valeur.
  5. Cliquez sur Enregistrer.
Pour enlever en bloc des balises définies

Suppression de plusieurs balises définies de ressources : procédure.

  1. Ouvrez le menu de navigation. Sous Gouvernance et administration, accédez à Gouvernance et cliquez sur Explorateur de location.

  2. Sélectionnez les ressources dont vous souhaitez enlever des balises. Vous pouvez éventuellement utiliser le menu déroulant Filtrer par type de ressource pour affiner la liste des ressources.

  3. Dans le menu Actions, cliquez sur Gérer les balises.

    La page Gérer les balises s'ouvre. La première table affiche les balises actuellement appliquées aux ressources sélectionnées. La seconde table affiche les ressources sélectionnées.

  4. Dans la liste des balises, trouvez la balise à enlever. Pour Action, sélectionnez Enlever la balise de toutes les ressources sélectionnées.
  5. Pour enlever une autre balise, répétez l'étape précédente.

  6. Cliquez sur Suivant.

    Une page de confirmation s'ouvre et répertorie les actions à entreprendre et les ressources auxquelles les actions s'appliquent.

  7. Cliquez sur Soumettre.

La page Demande de travail s'ouvre pour vous montrer le statut de la demande de travail visant à supprimer les balises des ressources.

Pour enlever une balise d'une seule ressource

  1. Ouvrez la console, cliquez sur le nom de service, puis sur la ressource à afficher.

    Par exemple, pour afficher une instance de calcul, ouvrez le menu de navigation. Sous Infrastructure de base, accédez à Compute et cliquez sur Instances. La liste des instances dans le compartiment en cours apparaît. Recherchez l'instance de laquelle enlever la balise, puis cliquez sur son nom pour afficher la page de détails correspondante.

  2. Cliquez sur Balises.

    La liste des balises appliquées à la ressource apparaît.

  3. Recherchez la balise à enlever et cliquez sur l'icône en forme de crayon en regard de celle-ci.
  4. Cliquez sur Enlever la balise.

Utilisation de l'API

Pour plus d'informations sur l'utilisation de l'API et la signature des demandes, reportez-vous à API REST et à Informations d'identification de sécurité. Pour plus d'informations sur les kits SDK, reportez-vous à Kits SDK et interface de ligne de commande.

  • Pour appliquer une balise à une ressource individuelle à l'aide de l'API, utilisez l'opération create ou update de la ressource appropriée.
  • BulkEditTags : ajoute, met à jour et supprime plusieurs définitions de clé de balise sur les ressources sélectionnées
  • ListBulkEditTagsResourceTypes : répertorie les types de ressource prenant en charge la modification des balises en masse