Documentation sur Oracle Cloud Infrastructure

Ajout de marqueurs à la création de ressources

Dans Compute Cloud@Customer, toutes les valeurs par défaut de marqueur définies dans un compartiment sont automatiquement ajoutées à toutes les ressources créées dans ce compartiment, ou dans tout compartiment enfant de ce compartiment, une fois la valeur par défaut de marqueur définie. Une valeur par défaut de marqueur peut nécessiter que vous entriez une valeur pour le marqueur afin de créer la ressource.

Note

Les marqueurs et les espaces de noms de marqueur définis doivent être configurés dans votre location OCI. Voir Marqueurs définis.

    1. Dans la boîte de dialogue Create (Créer) de 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 un marqueur à structure libre), entrez une clé de marqueur et entrez une valeur.

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

      Vous ne pouvez pas spécifier plus d'un marqueur avec le même espace de noms de marqueur et la même clé de marqueur pour un marqueur défini, ou plus d'un marqueur avec la même clé de marqueur 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 que vous voulez ajouter à la ressource.

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

        Créez 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.

        Créez 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 defined_tags.json de sortie est :

      {
  "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. 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 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 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 ressource create ou de la commande launch est la même que celle de la ressource get. La sortie affiche les marqueurs définis et à structure libre.

    Pour 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.