Documentation sur Oracle Cloud Infrastructure

Ajout de marqueurs à la création de ressource (IAM dans OCI)

Sur Compute Cloud@Customer, toutes les valeurs par défaut de marqueur définies sur un compartiment sont automatiquement ajoutées à toutes les ressources créées dans ce compartiment, ou à tout compartiment enfant de ce compartiment, une fois la valeur par défaut de marqueur définie. Un marqueur par défaut peut nécessiter l'entrée d'une valeur pour le marqueur afin de créer la ressource.

Note

Pour appliquer des marqueurs définis et des espaces de noms de marqueur lors de la création de la ressource, ils doivent être configurés dans votre location OCI à l'avance. Voir Marqueurs définis.

Les marqueurs à structure libre peuvent être créés et appliqués lors de la création de la ressource. Voir Marqueurs à structure libre

    1. Dans la boîte de dialogue Create (Créer) pour la ressource, accédez à la section Tagging (Marquage).

    2. Sélectionnez l'espace de noms de marqueur ou sélectionnez Aucun (pour appliquer un marqueur à structure libre).

      • Si vous avez sélectionné un espace de noms de marqueur, sélectionnez la clé de marqueur et entrez une valeur ou sélectionnez une valeur dans la liste.

      • Si vous avez sélectionné Aucun (appliquer une balise à structure libre), entrez une clé de balise et entrez une valeur.

    3. Pour appliquer une autre balise, sélectionnez le bouton Additional Tag.

      Vous ne pouvez pas spécifier plusieurs marqueurs avec le même espace de noms de marqueur et la même clé de marqueur pour un marqueur défini, ni plusieurs marqueurs avec la même clé pour un marqueur à structure libre.

    4. Pour vérifier les marqueurs de la ressource, allez à la page de détails de la nouvelle ressource.

      Dans la page des détails de la ressource, sélectionnez l'onglet Marqueurs pour afficher les marqueurs appliqués à cette ressource.

  • Pour ajouter un marqueur à une ressource lorsque vous créez la ressource, utilisez la commande create ou launch de la ressource.

    1. Obtenez les informations pour chaque marqueur à ajouter à la ressource.

      • Obtenez l'espace de noms, la clé et la valeur pour chaque marqueur défini à ajouter à la ressource.

        Construisez un argument pour l'option --defined-tags. Spécifiez chaque espace de noms de marqueur et chaque paire de clés de marqueur une seule fois.

      • Obtenez la clé et la valeur de chaque marqueur à structure libre que vous voulez ajouter à la ressource.

        Construisez un argument pour l'option --freeform-tags. Spécifiez chaque clé de marqueur une seule fois.

      La valeur de l'argument d'option --defined-tags et de l'argument d'option --freeform-tags est une définition JSON des marqueurs. Cette définition JSON peut être fournie sous forme de chaîne sur la ligne de commande ou dans un fichier.

      Vous pouvez générer un modèle JSON correct à fournir à l'aide de l'option --generate-param-json-input avec la commande de base que vous utiliserez pour marquer la ressource. L'argument de l'option --generate-param-json-input est le nom de l'option que vous utilisez pour spécifier les marqueurs (--defined-tags dans cet exemple) sans l'indicateur d'option (--), comme illustré dans l'exemple suivant :

      $ oci service resource create --generate-param-json-input defined-tags > defined_tags.json

      Le contenu du fichier de sortie defined_tags.json est le suivant :

      {
  "tagNamespace1": {
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2"
  },
  "tagNamespace2": {
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2"
  }
}

      Si vous spécifiez freeform-tags au lieu de defined-tags dans la commande précédente, vous obtenez la sortie suivante :

      {
  "tagKey1": "tagValue1",
  "tagKey2": "tagValue2"
}

      Modifiez ces modèles pour fournir les marqueurs appropriés. Indiquez le résultat dans la commande finale, comme indiqué à l'étape suivante.

    2. Exécutez la commande create ou launch de la ressource.

      Pour ajouter un ou plusieurs marqueurs définis, utilisez l'option --defined-tags. Pour ajouter un ou plusieurs marqueurs à structure libre, utilisez l'option --freeform-tags.

      Syntaxe :

      oci <service> <resource> create --compartment-id <compartment_OCID> --defined-tags <defined_tags_json> --freeform-tags <freeform_tags_json> <other_resource_create_options>

      Exemple :

      Dans l'exemple suivant, un ou plusieurs marqueurs définis sont ajoutés à l'aide d'un fichier et un marqueur à structure libre est ajouté à l'aide d'un argument de type chaîne. Utilisez la syntaxe file:// pour spécifier un fichier en tant qu'argument d'option.

      oci <service> <resource> create --compartment-id <compartment_OCID> --defined-tags file://defined_tags.json --freeform-tags '{"MyTag":"val-u"}' <other_resource_create_options>

      La sortie de la commande create ou launch de la ressource est identique à la sortie de la commande get de la ressource. La sortie affiche les marqueurs définis et à structure libre.

    Pour obtenir la liste complète des commandes, indicateurs et options de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande.

  • Pour ajouter un marqueur à une ressource lorsque vous créez la ressource, utilisez la commande create<resource> ou launch<resource>.

    Pour plus d'informations sur l'utilisation de l'API et sur les demandes de signature, voir 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.