Documentation Oracle Cloud Infrastructure

Utilisation des variables de balise

Vous pouvez utiliser une variable pour définir la valeur d'une balise définie. Lorsque vous ajoutez la balise à une ressource, la variable renvoie les données qu'elle représente. Vous pouvez utiliser des variables de balise dans des balises définies et des balises par défaut.

Notez les restrictions suivantes :

  • Vous ne pouvez pas utiliser une variable de balise en tant que valeur de balise prédéfinie. Pour plus d'informations sur l'utilisation des variables prédéfinies, reportez-vous à Utilisation de valeurs prédéfinies.
  • Vous ne pouvez pas utiliser de variables de balise dans des balises à format libre.

Stratégie IAM requise

Les variables de balise sont une fonctionnalité propre aux balises définies. Pour permettre aux utilisateurs de se servir des variables de balise, utilisez la même stratégie IAM que pour les espaces de noms de balise et les balises. Pour plus d'informations, reportez-vous à Droits d'accès requis pour utiliser des balises définies.

Si vous ne connaissez pas les stratégies, reportez-vous à Gestion des domaines d'identité et à Stratégies courantes. Si vous voulez en savoir plus sur l'écriture de stratégies pour les groupes ou d'autres composants IAM, reportez-vous à Détails relatifs à IAM sans domaine d'identité.

Utilisation des variables de balise

Prenons l'exemple suivant :

Operations.CostCenter="${iam.principal.name} à ${oci.datetime}"

Operations est l'espace de noms, CostCenter est la clé de balise et la valeur de balise contient deux variables de balise, ${iam.principal.name} et ${oci.datetime}. Lorsque vous ajoutez cette balise à une ressource, les variables se résolvent en votre nom utilisateur (nom du principal qui a appliqué la balise) et en un horodatage correspondant au moment où vous avez ajouté la balise.


			user_name at 2019-06-18T18:00:57.604Z

La variable est remplacée par des données au moment de l'application de la balise. Si vous modifiez ultérieurement la balise, la variable n'est plus affectée et seules les données sont conservées. Vous pouvez modifier la valeur de balise à l'aide de toutes les méthodes qui s'appliquent pour modifier toute autre valeur de balise.

Pour créer une variable de balise, vous devez utiliser un format spécifique. 

${<variable>}

Saisissez un signe dollar suivi d'accolades ouvrante et fermante. La variable de balise se trouve entre les accolades. Vous pouvez utiliser des variables de balise avec d'autres variables de balise et des valeurs de chaîne.

Variables de balise prises en charge

Les variables de balise suivantes sont prises en charge.

Variable Description
${iam.principal.name} Nom du principal ayant balisé la ressource.
${iam.principal.type} Type de principal ayant balisé la ressource.
${oci.datetime} Date et heure de création de la balise.