Documentation Oracle Cloud Infrastructure

Ajout de balises lors de la création de ressources (IAM dans OCI)

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 nécessiter que vous saisissiez une valeur pour la balise afin de créer la ressource.

Remarque

Pour appliquer des balises définies et des espaces de noms de balise lors de la création d'une ressource, vous devez les configurer dans votre location OCI à l'avance. Reportez-vous à Balises définies.

Les balises à format libre peuvent être créées et appliquées lors de la création de la ressource. Reportez-vous à Balises à format libre

    1. Faites défiler la boîte de dialogue Créer pour la ressource 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, entrez une valeur ou sélectionnez une valeur dans la liste.

      • Si vous avez sélectionné Aucun (appliquer une balise à format libre), entrez une clé de balise et entrez 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, ou plusieurs balises avec la même clé de balise pour une balise à format libre.

    4. Pour consulter 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 créez la ressource, utilisez la commande de ressource create ou launch.

    1. Obtenez les informations pour chaque balise que vous voulez ajouter à la ressource.

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

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

      • Obtenez la clé et la valeur de chaque balise à format libre que vous voulez 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 du JSON approprié à 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 spécifier 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 de sortie defined_tags.json 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 create ou launch de la ressource.

      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 à celle 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 de l'interface, reportez-vous à la Référence de ligne de commandes.

  • Pour ajouter une balise à 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 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.