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

Evitez de saisir des informations confidentielles lors de l'affectation de descriptions, de balises ou de noms conviviaux aux ressources cloud via la console, l'API ou l'interface de ligne de commande Oracle Cloud Infrastructure.

Utilisation des balises de ressource

Procédure d'ajout en masse de balises définies

Voici comment ajouter plusieurs balises définies à des ressources existantes. Pour appliquer des balises définies, vous devez être autorisé à utiliser l'espace de noms.

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

  2. Sélectionnez les ressources auxquelles ajouter des balises. Vous pouvez 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 nouvel élément.
    1. Sélectionnez l'espace de noms de balise.
    2. Sélectionnez la clé de balise.
    3. Saisissez une valeur dans le champ 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. Après avoir ajouté toutes les balises souhaitées, cliquez sur Suivant.

    Une page de confirmation s'ouvre. Elle répertorie les actions à effectuer et les ressources auxquelles celles-ci s'appliquent.

  7. Cliquez sur Soumettre.

La page Demande de travail s'ouvre pour afficher le statut de la demande de travail d'ajout de balises aux ressources.

Procédure d'ajout de 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, puis cliquez sur Compute. Sous Compute, 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, puis cliquez sur Compute. Sous Compute, 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 Ajouter un filtre de balise, procédez comme suit :
    1. espace de noms de balise : sélectionnez l'espace de noms de balise.
    2. Clé de balise : sélectionnez la clé.
    3. Valeur de balise : sélectionnez l'une des options suivantes :
      • Mettre en correspondance toutes les 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.
      • Indiquer les valeurs correspondantes : renvoie les ressources avec la valeur de balise que vous saisissez 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 Apply filter.
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 Ajouter un filtre de balise, procédez comme suit :
    1. Espace de noms de balise : sélectionnez Aucun (balise à format libre).
    2. clé de balise : entrez la clé.
    3. Valeur de balise : sélectionnez l'une des options suivantes :
      • Mettre en correspondance toutes les 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.
      • Indiquer les valeurs correspondantes : renvoie les ressources avec la valeur de balise que vous saisissez 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 Apply filter.
Procédure de mise à jour en masse de balises définies

Voici comment mettre à jour les balises définies appliquées à des ressources.

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

  2. Sélectionnez les ressources dont vous souhaitez mettre à jour les balises. Vous pouvez 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, recherchez la balise à mettre à jour et entrez une nouvelle valeur. Pour annuler 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. Elle répertorie les actions à effectuer et les ressources auxquelles celles-ci s'appliquent.

  7. Cliquez sur Soumettre.

La page Demande de travail s'ouvre pour afficher le statut de la demande de travail de mise à jour des balises sur les ressources.

Procédure de mise à jour d'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, puis cliquez sur Compute. Sous Compute, 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.
Procédure de suppression en masse de balises définies

Voici comment enlever plusieurs balises définies des ressources.

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

  2. Sélectionnez les ressources desquelles enlever des balises. Vous pouvez 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, recherchez 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. Elle répertorie les actions à effectuer et les ressources auxquelles celles-ci s'appliquent.

  7. Cliquez sur Soumettre.

La page Demande de travail s'ouvre pour afficher le statut de la demande de travail de suppression de balises des ressources.

Procédure de suppression d'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, puis cliquez sur Compute. Sous Compute, 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 à la documentation relative à l'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 seule ressource à l'aide de l'API, utilisez l'opération create ou update de la ressource appropriée.
  • BulkEditTags : permet d'ajouter, de mettre à jour et d'enlever plusieurs définitions de clé de balise sur les ressources sélectionnées
  • ListBulkEditTagsResourceTypes : permet de répertorier les types de ressource qui prennent en charge la modification de balises en masse