Documentation sur Oracle Cloud Infrastructure

Marqueurs de ressource

Lorsque vous utilisez de nombreuses ressources (par exemple, des instances, des réseaux en nuage virtuels, des équilibreurs de charge et des volumes par blocs) dans plusieurs compartiments de votre location, il peut être difficile d'effectuer le suivi des ressources utilisées à des fins spécifiques, de les agréger ou encore de créer des rapports ou d'entreprendre des actions en masse sur ces ressources. Le marquage vous permet de définir des clés et des valeurs et de les associer à des ressources. Vous pouvez ensuite utiliser les marqueurs pour organiser et répertorier les ressources en fonction des besoins de votre entreprise.

Il existe deux types de marqueur :

Les marqueurs définis sont configurés dans votre location par un administrateur. Seuls les utilisateurs autorisés à utiliser les marqueurs définis peuvent appliquer ceux-ci aux ressources.

Les marqueurs à structure libre peuvent être appliqués par n'importe quel utilisateur autorisé à utiliser la ressource.

Pour obtenir des informations plus détaillées sur les marqueurs et leurs fonctions, voir Aperçu du service de marquage.

Conseil

Regardez une vidéo qui décrit les concepts et les fonctions du marquage : Présentation du marquage.
Attention

Évitez d'entrer des informations confidentielles lors de l'affectation de descriptions, de marqueurs ou de noms conviviaux à des ressources en nuage au moyen de la console, de l'API ou de l'interface de ligne de commande Oracle Cloud Infrastructure.

Utilisation des marqueurs de ressource

Pour ajouter en masse des marqueurs définis

Comment ajouter plusieurs marqueurs définis aux ressources existantes. Pour appliquer des marqueurs définis, vous devez être autorisé à utiliser l'espace de noms.

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

  2. Sélectionnez les ressources auxquelles vous souhaitez ajouter des marqueurs. Facultativement, utilisez le menu déroulant Filtrer par type de ressource pour restreindre la liste des ressources.

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

    La page Gérer les marqueurs s'ouvre. Le premier tableau affiche les marqueurs actuellement appliqués aux ressources sélectionnées. La seconde table affiche les ressources sélectionnées.

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

  6. Lorsque vous avez ajouté tous les marqueurs voulus, cliquez sur Suivant.

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

  7. Cliquez sur Soumettre.

La page Demande de travail affiche le statut de la demande de travail associée à l'ajout de marqueurs aux ressources.

Pour ajouter des marqueurs définis à une ressource existante

Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms.

  1. Ouvrez la console et accédez à la page de détails de la ressource à marquer.

    Par exemple, pour marquer une instance de calcul : Ouvrez le menu de navigation et cliquez sur Calcul. Sous Calcul, cliquez sur Instances. La liste des instances du compartiment courant s'affiche. Recherchez l'instance à marquer et cliquez sur son nom pour consulter la page de détails correspondante.

  2. Cliquez sur Appliquer des marqueurs. Selon la ressource, cette option peut être disponible dans le menu Actions supplémentaires.

  3. Dans la boîte de dialogue Appliquer des marqueurs à la ressource :

    1. Sélectionnez l'espace de noms de marqueur.
    2. Sélectionnez la clé de marqueur.
    3. Dans Valeur, entrez une valeur ou sélectionnez-en une dans la liste.
    4. Pour appliquer un autre marqueur, cliquez sur + Marqueur supplémentaire.
    5. Lorsque vous avez terminé d'ajouter des marqueurs, cliquez sur Appliquer les marqueurs.
Pour ajouter un marqueur à structure libre à une ressource existante

  1. Ouvrez la console et accédez à la page de détails de la ressource à marquer.

    Par exemple, pour marquer une instance de calcul : Ouvrez le menu de navigation et cliquez sur Calcul. Sous Calcul, cliquez sur Instances. La liste des instances du compartiment courant s'affiche. Recherchez l'instance à marquer et cliquez sur son nom pour consulter la page de détails correspondante.

  2. Cliquez sur Appliquer des marqueurs. Selon la ressource, cette option peut être disponible dans le menu Actions supplémentaires.

  3. Dans la boîte de dialogue Appliquer des marqueurs à la ressource :

    1. Sélectionnez Aucun (appliquer un marqueur à structure libre).
    2. Entrez la clé de marqueur.
    3. Entrez une valeur.
    4. Pour appliquer un autre marqueur, cliquez sur + Marqueur supplémentaire.
    5. Lorsque vous avez terminé d'ajouter des marqueurs, cliquez sur Appliquer les marqueurs.
Pour ajouter un marqueur lors de la création d'une ressource

Vous pouvez appliquer des marqueurs lors de la création des ressources. L'emplacement de l'option Appliquer les marqueurs dans la boîte de dialogue varie selon la ressource. Les étapes générales sont les suivantes :

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

    Pour certaines ressources, vous devez cliquer sur Afficher les options avancées pour appliquer un marqueur.

  2. Dans la boîte de dialogue Appliquer des marqueurs à la ressource :

    1. Sélectionnez l'espace de noms de marqueur ou sélectionnez Aucun pour appliquer un marqueur à structure libre.
    2. Sélectionnez ou entrez la clé de marqueur.
    3. Dans Valeur, entrez une valeur ou sélectionnez-en une dans la liste.
    4. Pour appliquer un autre marqueur, cliquez sur + Marqueur supplémentaire.
    5. Cliquez sur Appliquer les marqueurs.
Pour filtrer une liste de ressources par marqueur

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

Par exemple, pour afficher les instances de calcul : Cliquez sur Calcul, puis sur Instances pour voir la liste des instances du compartiment courant.

Pour filtrer une liste de ressources en fonction d'un marqueur défini
  1. À côté de Filtres de marqueurs, cliquez sur Ajouter.
  2. Dans la boîte de dialogue Ajouter un filtre de marqueur, entrez les informations suivantes :
    1. Espace de noms de marqueur : Sélectionnez celui-ci.
    2. Clé de marqueur : Sélectionnez la clé.
    3. Valeur du marqueur : Sélectionnez l'une des valeurs suivantes :
      • atch any value - Retourne toutes les ressources marquées avec l'espace de noms et la clé sélectionnés, quelle que soit la valeur du marqueur.
      • Spécifier les valeurs correspondantes - Retourne les ressources avec la valeur de marqueur que vous entrez dans la zone de texte. Entrez une valeur unique dans la zone de texte. Pour spécifier plusieurs valeurs pour le même espace de noms et la même clé, cliquez sur + pour afficher une autre zone de texte. Entrez une valeur par zone de texte.
    4. Cliquez sur Appliquer le filtre.
Pour filtrer une liste de ressources en fonction d'un marqueur à structure libre
  1. À côté de Filtres de marqueurs, cliquez sur Ajouter.
  2. Dans la boîte de dialogue Ajouter un filtre de marqueur, entrez les informations suivantes :
    1. Espace de noms de marqueur : Sélectionnez Aucun (marqueur à structure libre).
    2. Clé de marqueur : Entrez la clé.
    3. Valeur du marqueur : Sélectionnez l'une des valeurs suivantes :
      • atch any value - Retourne toutes les ressources marquées avec l'espace de noms et la clé sélectionnés, quelle que soit la valeur du marqueur.
      • Spécifier les valeurs correspondantes - Retourne les ressources avec la valeur de marqueur que vous entrez dans la zone de texte. Entrez une valeur unique dans la zone de texte. Pour spécifier plusieurs valeurs pour le même espace de noms et la même clé, cliquez sur + pour afficher une autre zone de texte. Entrez une valeur par zone de texte.
    4. Cliquez sur Appliquer le filtre.
Pour mettre à jour en masse des marqueurs définis

Comment mettre à jour les marqueurs définis appliqués à une ou plusieurs ressources.

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

  2. Sélectionnez les ressources pour lesquelles vous voulez mettre à jour des marqueurs. Facultativement, utilisez le menu déroulant Filtrer par type de ressource pour restreindre la liste des ressources.

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

    La page Gérer les marqueurs s'ouvre. Le premier tableau affiche les marqueurs actuellement appliqués aux ressources sélectionnées. La seconde table affiche les ressources sélectionnées.

  4. Dans la liste des marqueurs, recherchez le marqueur à mettre à jour et entrez une nouvelle valeur. Pour annuler la modification, cliquez sur le bouton Annuler.
  5. Pour Action, sélectionnez Appliquer un marqueur à toutes les ressources sélectionnées.

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

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

  7. Cliquez sur Soumettre.

La page Demande de travail affiche le statut de la demande de travail associée à la mise à jour des marqueurs sur les ressources.

Pour mettre à jour un marqueur appliqué à une seule ressource

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

    Par exemple, pour afficher les instances de calcul : Ouvrez le menu de navigation et cliquez sur Calcul. Sous Calcul, cliquez sur Instances. La liste des instances du compartiment courant s'affiche. Recherchez l'instance à mettre à jour et cliquez sur son nom pour consulter la page de détails correspondante.

  2. Cliquez sur Marqueurs.

    La liste des marqueurs appliqués à la ressource s'affiche.

  3. Recherchez le marqueur à mettre à jour et cliquez sur l'icône en forme de crayon située à côté de celui-ci.
  4. Entrez ou sélectionnez une nouvelle valeur.
  5. Cliquez sur enregistrer.
Pour supprimer en masse des marqueurs définis

Comment supprimer plusieurs marqueurs définis des ressources.

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

  2. Sélectionnez les ressources pour lesquelles vous voulez supprimer des marqueurs. Facultativement, utilisez le menu déroulant Filtrer par type de ressource pour restreindre la liste des ressources.

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

    La page Gérer les marqueurs s'ouvre. Le premier tableau affiche les marqueurs actuellement appliqués aux ressources sélectionnées. La seconde table affiche les ressources sélectionnées.

  4. Dans la liste des marqueurs, recherchez le marqueur que vous voulez supprimer. Pour Action, sélectionnez Supprimer le marqueur de toutes les ressources sélectionnées.
  5. Pour supprimer un autre marqueur, répétez l'étape précédente.

  6. Cliquez sur Suivant.

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

  7. Cliquez sur Soumettre.

La page Demande de travail affiche le statut de la demande de travail associée à la suppression des marqueurs des ressources.

Pour supprimer un marqueur d'une seule ressource

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

    Par exemple, pour afficher une instance de calcul : Ouvrez le menu de navigation et cliquez sur Calcul. Sous Calcul, cliquez sur Instances. La liste des instances du compartiment courant s'affiche. Recherchez l'instance à supprimer et cliquez sur son nom pour consulter la page de détails correspondante.

  2. Cliquez sur Marqueurs.

    La liste des marqueurs appliqués à la ressource s'affiche.

  3. Recherchez le marqueur à supprimer et cliquez sur l'icône en forme de crayon située à côté de celui-ci.
  4. Cliquez sur Supprimer le marqueur.

Utilisation de l'API

Pour plus d'informations sur l'utilisation de l'API et sur les demandes de signature, voir la documentation de l'API REST et Données d'identification de sécurité. Pour plus d'informations sur les trousses SDK, voir Trousses SDK et interface de ligne de commande.

  • Pour appliquer un marqueur à une ressource à 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 marqueur sur les ressources sélectionnées
  • ListBulkEditTagsResourceTypes - Liste les types de ressource qui prennent en charge la modification de marqueurs en masse