Présentation de Tagging

Le service Tagging vous permet d'ajouter des balises aux ressources de deux façons.

Chacune d'elles permet d'utiliser un type de balise différent :

• Balises définies : les administrateurs de balises gèrent les métadonnées de ressource.
• Balises à format libre : métadonnées non gérées appliquées aux ressources par les utilisateurs.

Selon la première méthode, un administrateur de balises crée et gère toutes les balises que les utilisateurs appliquent aux ressources. Utilisez la stratégie IAM pour sélectionner les administrateurs de balises autorisés à créer des balises. Accordez à tous les autres utilisateurs de la location le droit d'appliquer des balises uniquement. Cette approche vous permet de créer et de gérer les clés et les valeurs utilisées pour baliser les ressources. Vous pouvez ainsi éviter les fautes de frappe qui affaiblissent l'automatisation basée sur les balises et renforcer la génération de rapports reposant sur ces mêmes balises.

L'autre méthode consiste à autoriser les utilisateurs à ajouter des balises aux ressources. Chaque balise est modifiée ou appliquée au niveau de la ressource par vous ou par un utilisateur qui crée ou modifie une ressource. Vous pouvez utiliser les deux types de balise dans votre location.

La plupart des fonctionnalités de Tagging nécessitent des balises définies. Le terme "balise" est utilisé de façon générique pour faire référence aux balises définies. Pour créer des métadonnées fiables afin de gérer des ressources et de collecter des données, utilisez des balises définies. Les scénarios suivants sont rendus possibles grâce aux balises définies :

• Créez des balises par défaut appliquées à toutes les ressources dans les compartiments. Reportez-vous à Gestion des valeurs de balise par défaut.
• Indiquez que les utilisateurs doivent appliquer des balises aux ressources pour créer des ressources dans des compartiments.
• Si vous faites une faute de frappe en utilisant des balises définies, corrigez-la en modifiant la balise concernée ou en la supprimant. Lorsque vous supprimez une balise définie, Oracle enlève la clé et toute valeur associée de toutes les ressources. Reportez-vous à Suppression des espaces de noms et des définitions de clé de balise.
• Associez une liste de valeurs prédéfinies à une balise définie. Reportez-vous à Utilisation de valeurs prédéfinies.
• Utilisez des variables système afin de générer automatiquement des valeurs pour des balises définies ou des valeurs de balise par défaut. Reportez-vous à Utilisation des variables de balise.
• Assurez le suivi des coûts en fonction des balises. L'utilisation de balises définies est recommandée pour ce cas d'emploi.

Décrit les concepts de base relatifs au balisage.

Voici la liste des concepts de balisage de base :

Espace de noms de balise

Voyez l'espace de noms de balise comme un conteneur pour vos clés de balise. Il se compose d'un nom, et de définitions de clé de balise, le cas échéant. Les espaces de noms de balise ne respectent pas la casse et doivent être uniques dans la location. L'espace de noms est également un regroupement naturel auquel les administrateurs peuvent appliquer une stratégie. Une stratégie appliquée à un espace de noms de balise s'applique à toutes les définitions de balise qu'il contient.

Remarque

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

Clé de balise

Nom que vous utilisez pour faire référence à la balise. Les clés de balise ne respectent pas la casse. Par exemple, mytagkey duplique MyTagKey. Vous devez créer des clés de balise pour les balises définies dans un espace de noms. Chaque clé de balise doit être unique dans un espace de noms.

Type de valeur de balise

Le type de valeur de balise indique le type de données autorisé pour la valeur. Actuellement, deux types de données sont pris en charge : la chaîne et la liste de chaînes.

Définition de clé

Une définition de clé définit le schéma d'une balise et inclut un espace de noms, une clé de balise et un type de valeur de balise.

Remarque

Vous ne pouvez pas modifier le nom de votre définition de clé de balise. Cependant, vous pouvez la retirer

Valeur de balise

La valeur de balise correspond à la valeur que l'utilisateur appliquant la balise ajoute à la clé de balise. Les valeurs de balise prennent en charge deux types de données : les chaînes et les listes de chaînes. Vous pouvez définir une liste de valeurs dans laquelle l'utilisateur doit effectuer une sélection lorsque vous définissez la clé de balise, ou bien autoriser l'utilisateur à saisir n'importe quelle valeur lorsque la balise est appliquée à la ressource. Si vous sélectionnez une valeur de balise de chaîne lors de la création de la clé, l'utilisateur peut laisser cette valeur vide lorsqu'il applique la clé.

Dans l'exemple suivant :

Operations.CostCenter="42"

Operations est l'espace de noms, CostCenter est la clé de balise et 42 est la valeur de balise.

Balise (ou balise définie)

Une balise est l'instance d'une définition de clé appliquée à une ressource. Elle se compose d'un espace de noms, d'une clé et d'une valeur. Le terme "balise" est utilisé de façon générique pour faire référence aux balises définies.

Balise à format libre

Association de métadonnées de base, composée uniquement d'une clé et d'une valeur. Les balises à format libre ont des fonctionnalités limitées. Reportez-vous à Présentation des balises à format libre.

Suivi des coûts

Le suivi des coûts est une fonctionnalité disponible avec les balises définies. Pour comprendre quand vous devez définir une balise comme balise de suivi des coûts, reportez-vous à Utilisation de balises de suivi des coûts.

Valeur de balise par défaut

Les valeurs de balise par défaut vous permettent d'indiquer les balises qui sont appliquées automatiquement à toutes les ressources d'un compartiment spécifique au moment de leur création, quels que soient les droits d'accès de l'utilisateur qui crée la ressource. Reportez-vous à Gestion des valeurs de balise par défaut.

Mise hors service

Vous pouvez mettre hors service une définition de clé de balise ou un espace de noms de balise. Les espaces de noms de balise et les définitions de clé mis hors service ne peuvent plus être appliqués aux ressources. Toutefois, les balises mises hors service ne sont pas enlevées des ressources auxquelles elles ont déjà été appliquées. Vous pouvez quand même spécifier des balises mises hors service lors des opérations de recherche, de filtrage, de génération de rapports, etc.

Réactivation

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

Variable de balise

Vous pouvez utiliser une variable pour définir la valeur d'une balise. Lorsque vous ajoutez ou mettez à jour une balise sur une ressource, la variable renvoie les données qu'elle représente. Reportez-vous à Utilisation des variables de balise.

Valeurs prédéfinies

Vous pouvez utiliser une variable pour définir la valeur d'une balise. Lorsque vous ajoutez ou mettez à jour une balise sur une ressource, la variable renvoie les données qu'elle représente. Reportez-vous à Utilisation de valeurs prédéfinies.

EXEMPLE DE BALISE

{
  "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 : reportez-vous aux rubriques suivantes pour obtenir un exemple de stratégie IAM pour le service Tagging :

• Droits d'accès requis pour utiliser des balises définies
• Droits d'accès requis pour utiliser des valeurs de balise par défaut
• Droits d'accès requis pour utiliser des balises à format libre

Tagging est actuellement disponible dans toutes les régions.

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

• Balises par location : illimité
• Balises par ressource : 10 balises à format libre et 64 balises définies
• Balises activées pour le suivi des coûts : 10 par location (y compris les balises actives et mises hors service)
• Taille totale des données de balise : 5 000 octets (JSON). La taille totale des données de balise inclut toutes les données de balise d'une seule ressource (toutes les balises et valeurs de balise appliquées). Le dimensionnement s'effectue conformément à UTF-8.
• Nombre de valeurs prédéfinies pour une clé de balise : 100 par liste

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

Le tableau suivant répertorie les ressources prenant en charge le balisage. Ce tableau sera mis à jour lors de l'ajout de la prise en charge du balisage pour d'autres ressources.