Utilisation des variables de marqueur

Vous pouvez utiliser une variable pour définir la valeur d'un marqueur défini. Lorsque vous ajoutez le marqueur à une ressource, la variable est résolue aux données qu'elle représente. Vous pouvez utiliser des variables de marqueur dans des marqueurs définis et des marqueurs par défaut.

Notez les limitations suivantes :

  • Vous ne pouvez pas utiliser une variable de marqueur comme valeur de marqueur prédéfinie. Voir Utilisation de valeurs prédéfinies pour plus d'informations sur l'utilisation de variables prédéfinies
  • Vous ne pouvez pas utiliser de variables de marqueur dans les marqueurs à structure libre.

Politique GIA requise

Les variables de marqueur constituent une fonctionnalité des marqueurs définis. Pour permettre aux utilisateurs d'utiliser des variables de marqueur, utilisez la même politique IAM pour utiliser les espaces de noms et les marqueurs de marqueur. Pour plus d'informations, voir Autorisations requises pour l'utilisation de marqueurs définis.

Pour en savoir plus sur les politiques, voir Gestion des domaines d'identité et Politiques communes. Pour en savoir plus sur l'écriture de politiques pour des groupes ou d'autres composants IAM, voir Informations détaillées sur le service IAM sans domaine d'identité.

Fonctionnement des variables de marqueur

Prenez l'exemple suivant :

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

Operations est l'espace de noms, CostCenter est la clé de marqueur et la valeur du marqueur contient deux variables : ${iam.principal.name} et ${oci.datetime}. Lorsque vous ajoutez ce marqueur à une ressource, la variable est résolue à votre nom d'utilisateur (nom du principal qui a appliqué le marqueur) et à l'horodatage d'ajout du marqueur.


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

La variable est remplacée par des données au moment où vous appliquez le marqueur. Si vous modifiez le marqueur plus tard, la variable disparaît et seules les données sont conservées. Vous pouvez modifier la valeur de marqueur de la même façon que vous modifieriez toute autre valeur de marqueur.

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

${<variable>}

Entrez un signe dollar suivi d'une accolade ouvrante et fermante. La variable de marqueur est entre les accolades. Vous pouvez utiliser des variables de marqueur avec d'autres variables de marqueur et des valeurs de chaîne.

Variables de marqueur prises en charge

Les variables de marqueur suivantes sont prises en charge.

Variable Description
${iam.principal.name} Nom du principal qui a marqué la ressource.
${iam.principal.type} Type de principal qui a marqué la ressource.
${oci.datetime} Date et heure de création du marqueur.