Aperçu du marquage

Le service de marquage permet d'ajouter des marqueurs aux ressources selon deux approches.

Chaque approche offre un type différent de marqueur :

• Marqueurs définis - Les administrateurs de marqueurs gèrent les métadonnées des ressources.
• Marqueurs à structure libre - Des métadonnées non gérées sont appliquées aux ressources par les utilisateurs.

Dans la première approche, un administrateur crée et gère tous les marqueurs que les utilisateurs appliquent aux ressources. Utilisez la politique GIA pour sélectionner les administrateurs de marqueurs qui peuvent créer des marqueurs. Limitez tous les autres utilisateurs de la location à la possibilité d'appliquer des marqueurs. L'avantage de cette approche est que vous pouvez créer et gérer les clés et les valeurs utilisées pour marquer les ressources. Cela évite les fautes d'orthographe, qui peuvent avoir une incidence négative sur l'automatisation et la génération de rapports en fonction de marqueurs.

L'autre approche autorise les utilisateurs à ajouter eux-mêmes des marqueurs aux ressources. Chaque marqueur est modifié ou appliqué à une ressource par vous ou par un utilisateur qui crée ou modifie cette ressource. Vous pouvez utiliser les deux types de marqueur dans l'ensemble de votre location.

La plupart des fonctionnalités du service de marquage requièrent des marqueurs définis. Le terme "marqueur" est employé de manière générique pour désigner des marqueurs définis. Afin de créer des métadonnées fiables pour gérer les ressources et collecter des données, utilisez des marqueurs définis. Avec des marqueurs définis, les scénarios suivants deviennent possibles :

• Vous pouvez créer des marqueurs par défaut qui sont appliqués à toutes les ressources dans les compartiments. Voir Gestion des valeurs par défaut de marqueur.
• Vous pouvez imposer aux utilisateurs d'appliquer des marqueurs aux ressources pour pouvoir créer des ressources dans des compartiments.
• Si vous faites une faute d'orthographe en utilisant des marqueurs définis, vous pouvez la corriger en modifiant le marqueur, ou en le supprimant. Lorsque vous supprimez un marqueur défini, Oracle supprime la clé (et toute valeur associée à ce marqueur) de toutes les ressources. Voir Suppression des définitions de clé et des espaces de noms de marqueur.
• Vous pouvez associer une liste de valeurs prédéfinies à un marqueur défini. Voir Utilisation de valeurs prédéfinies.
• Utilisez des variables de système pour générer automatiquement des valeurs pour les marqueurs définis ou les valeurs par défaut de marqueur. Voir Utilisation de variables de marqueur.
• Vous pouvez suivre les coûts en fonction de marqueurs. L'utilisation de marqueurs définis est recommandée pour ce cas d'utilisation.

Décrit les concepts de marquage de base.

Voici les concepts de marquage de base :

ESPACE DE NOMS DE MARQUEUR

Un espace de noms de marqueur est un conteneur pour vos clés de marqueur. Il est constitué d'un nom et de zéro, une ou plusieurs définitions de clé de marqueur. Les espaces de noms de marqueur ne sont pas sensibles à la casse et doivent être uniques pour la location. L'espace de noms est également un regroupement naturel auquel les administrateurs peuvent appliquer une politique. Si une politique est associée à un espace de noms de marqueur, elle s'applique à toutes les définitions de marqueur qu'il contient.

Note

• Vous ne pouvez pas utiliser l'OCID pour nommer l'espace de noms de marqueur, car les OCID ne respectent pas le format requis pour nommer les espaces de noms de marqueur.
• Vous ne pouvez pas modifier le nom de votre espace de noms de marqueur. Cependant, vous pouvez le mettre hors service.

CLÉ DE MARQUEUR

Nom que vous utilisez pour référencer un marqueur. Les clés de marqueur ne sont pas sensibles à la casse. Par exemple, mytagkey est un double de MyTagKey. Vous devez créer des clés de marqueur pour les marqueurs définis dans un espace de noms. Chaque clé de marqueur doit être unique dans un espace de noms.

TYPE DE VALEUR DE MARQUEUR

Le type de valeur de marqueur spécifie le type de données autorisé pour la valeur. Deux types de données sont actuellement pris en charge : chaîne et liste de chaînes.

DÉFINITION DE CLÉ

Une définition de clé établit le schéma d'un marqueur et comprend un espace de noms, une clé de marqueur et un type de valeur de marqueur.

Note

Vous ne pouvez pas modifier le nom de votre définition de clé de marqueur. Cependant, vous pouvez le mettre hors service

VALEUR DU MARQUEUR

La valeur du marqueur est la valeur ajoutée à la clé de marqueur par l'utilisateur qui applique le marqueur. Les valeurs de marqueur prennent en charge deux types de données : chaînes et listes de chaînes. Lorsque vous définissez une clé de marqueur, vous pouvez définir une liste de valeurs dans laquelle l'utilisateur peut effectuer une sélection, ou vous pouvez autoriser l'utilisateur à entrer une valeur quelconque lorsque le marqueur est appliqué à une ressource. Si vous sélectionnez une valeur de marqueur de type chaîne lors de la création de la clé, l'utilisateur peut laisser la valeur vide lorsqu'il applique la clé.

Dans l'exemple qui suit :

Operations.CostCenter="42"

L'espace de noms est Operations. CostCenter est la clé de marqueur, et 42, est la valeur du marqueur.

MARQUEUR (OU MARQUEUR DÉFINI)

Un marqueur est l'instance d'une définition de clé appliquée à une ressource. Il se compose d'un espace de noms, d'une clé et d'une valeur. Le terme "marqueur" est employé de manière générique pour désigner des marqueurs définis.

MARQUEUR À STRUCTURE LIBRE

Association de métadonnées de base constituée d'une clé et d'une valeur uniquement. Les marqueurs à structure libre ont des fonctionnalités limitées. Voir Présentation des marqueurs à structure libre.

SUIVI DES COÛTS

Le suivi des coûts est une fonction disponible avec les marqueurs définis. Pour savoir quand vous devez désigner un marqueur comme marqueur de suivi des coûts, voir Utilisation des marqueurs de suivi des coûts.

VALEUR PAR DÉFAUT DE MARQUEUR

Les valeurs de marqueur par défaut vous permettent de spécifier les marqueurs à appliquer automatiquement à toutes les ressources d'un compartiment spécifique au moment de la création, indépendamment des autorisations de l'utilisateur qui crée la ressource. Voir Gestion des valeurs par défaut de marqueur.

METTRE HORS SERVICE

Vous pouvez mettre hors service une définition de clé de marqueur ou un espace de noms de marqueur. Les espaces de noms et les définitions de clé mis hors service ne peuvent plus être appliqués aux ressources. Toutefois, les marqueurs mis hors service ne sont pas supprimés des ressources auxquelles ils ont déjà été appliqués. Vous pouvez spécifier des marqueurs mis hors service pour les recherches, le filtrage, la production de rapports, etc.

RÉACTIVER

Vous pouvez réactiver un espace de noms ou une définition de clé de marqueur qui a été mis hors service pour rétablir son utilisation dans votre location.

VARIABLE DE MARQUEUR

Vous pouvez utiliser une variable pour définir la valeur d'un marqueur. Lorsque vous ajoutez ou mettez à jour un marqueur pour une ressource, la variable résout les données qu'elle représente. Voir Utilisation de variables de marqueur.

VALEURS PRÉDÉFINIES

Vous pouvez utiliser une variable pour définir la valeur d'un marqueur. Lorsque vous ajoutez ou mettez à jour un marqueur pour une ressource, la variable résout les données qu'elle représente. Voir Utilisation de valeurs prédéfinies.

EXEMPLE DE MARQUEUR

{
  "compartmentId": "ocid.compartment.oc1..exampleuniquecompartmentID",
  "namespace": "ansh8lvru1zp",
  "objectEventsEnabled": true,
  "name": "my-test-1",
  "freeformTags": {"Department": "Finance"},
  "definedTags":
  {
    "MyTags":
    {
      "CostCenter": "42",
      "Project": "Stealth",
      "CreatedBy": "BillSmith",
      "CreatedDate": "9/21/2017T14:00"
    },
    "Audit":
    {
      "DataSensitivity": "PII",
      "CageSecurity": "High",
      "Simplicity": "complex"
    }
  }
}

Pour les administrateurs : Consultez les rubriques suivantes pour voir un exemple de politique GIA pour le marquage :

• Autorisations requises pour l'utilisation de marqueurs définis
• Autorisations requises pour l'utilisation de valeurs par défaut de marqueur
• Autorisations requises pour l'utilisation de marqueurs à structure libre

Le service de marquage est actuellement disponible dans toutes les régions.

Découvrez les limites par ressource pour les marqueurs et les caractères pris en charge dans les chaînes de marqueur.

• Marqueurs par location : Aucune limite
• Marqueurs par ressource : 10 marqueurs à structure libre et 64 marqueurs définis
• Marqueurs activés pour le suivi des coûts : 10 par location (comprend les marqueurs actifs et les marqueurs désactivés)
• Taille totale des données de marqueur : 5 K (JSON). La taille totale des données de marqueur inclut toutes les données de marqueur pour une ressource (tous les marqueurs et valeurs de marqueur appliqués). La taille est en UTF-8.
• Nombre de valeurs prédéfinies pour une clé de marqueur : 100 par liste

Fournit la liste des ressources prises en charge par le marquage.

Le tableau suivant répertorie les ressources qui prennent en charge le marquage. Ce tableau sera mis à jour lorsque la prise en charge du marquage sera ajoutée pour d'autres ressources.