Documentation Oracle Cloud Infrastructure

Ajout de balises à la création de ressources

Sur Compute Cloud@Customer, toutes les valeurs de balise par défaut 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 de balise par défaut définie. Une valeur de balise par défaut peut vous obliger à entrer une valeur pour la balise afin de créer la ressource.

Remarque

Les balises définies et les espaces de noms de balise doivent être configurés dans votre location OCI. Reportez-vous à Balises définies.

    1. Dans la boîte de dialogue Créer de la ressource, faites défiler la page jusqu'à la section Balisage.

    2. Sélectionnez l'espace de noms de balise ou sélectionnez Aucun (pour appliquer une balise à format libre).

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

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

    3. Pour appliquer une autre balise, cliquez sur le bouton Balise supplémentaire.

      Vous ne pouvez pas indiquer plusieurs balises avec le même espace de noms de balise et la même clé de balise pour une balise définie, ni plusieurs balises avec la même clé de balise pour une balise à format libre.

    4. Pour vérifier les balises de la ressource, accédez à la page de détails de la nouvelle ressource.

      Sur la page de détails de la ressource, sélectionnez l'onglet Balises pour afficher les balises appliquées à cette ressource.

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

    1. Obtenez les informations de chaque balise à ajouter à la ressource.

      • Obtenez l'espace de noms, la clé et la valeur de chaque balise définie à ajouter à la ressource.

        Créez un argument pour l'option --defined-tags. Indiquez une seule fois chaque espace de noms de balise et paire de clés de balise.

      • Obtenez la clé et la valeur de chaque balise à format libre que vous souhaitez ajouter à la ressource.

        Créez un argument pour l'option --freeform-tags. Indiquez chaque clé de balise 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 balises. 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 au format JSON correct à fournir en utilisant l'option --generate-param-json-input avec la commande de base que vous utiliserez pour baliser la ressource. L'argument de l'option --generate-param-json-input est le nom de l'option que vous utilisez pour indiquer les balises (--defined-tags dans cet exemple) sans l'indicateur d'option (--), comme indiqué dans l'exemple suivant :

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

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

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

      Si vous indiquez 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 balises appropriées. Spécifiez le résultat dans la commande finale comme indiqué à l'étape suivante.

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

      Pour ajouter des balises définies, utilisez l'option --defined-tags. Pour ajouter des balises à format 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, une ou plusieurs balises définies sont ajoutées à l'aide d'un fichier et une balise à format libre est ajoutée à l'aide d'un argument de chaîne. Utilisez la syntaxe file:// pour indiquer un fichier comme 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 de ressource create ou launch est identique à la sortie de la commande de ressource get. La sortie affiche les balises définies et à format libre.

    Pour obtenir la liste complète des commandes, des indicateurs et des options d'interface de ligne de commande, reportez-vous à Référence de ligne de commande.

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

    Pour plus d'informations sur l'utilisation de l'API et la signature des demandes, reportez-vous à API REST et à Informations d'identification de sécurité. Pour plus d'informations sur les kits SDK, reportez-vous à Kits SDK et interface de ligne de commande.