Oracle Cloud Infrastructure-Dokumentation

Tags bei der Ressourcenerstellung hinzufügen (IAM in OCI)

In Compute Cloud@Customer werden Tagstandardwerte, die in einem Compartment definiert sind, automatisch allen Ressourcen hinzugefügt, die in diesem Compartment oder einem untergeordneten Compartment dieses Compartments erstellt werden, nachdem der Tagstandard definiert wurde. Bei einem Tagstandardwert müssen Sie möglicherweise einen Wert für das Tag eingeben, um die Ressource zu erstellen.

Hinweis

Um definierte Tags und Tag-Namespaces während der Ressourcenerstellung anzuwenden, müssen sie im Voraus in Ihrem OCI-Mandanten konfiguriert werden. Siehe Definierte Tags.

Freiformtags können während der Ressourcenerstellung erstellt und angewendet werden. Siehe Freiformtags

    1. Scrollen Sie im Dialogfeld "Erstellen" für die Ressource zum Abschnitt "Tagging".

    2. Wählen Sie den Tag-Namespace aus, oder wählen Sie "Kein Wert" aus (um ein Freiformtag anzuwenden).

      • Wenn Sie einen Tag-Namespace ausgewählt haben, wählen Sie den Tagschlüssel aus, und geben Sie einen Wert ein, oder wählen Sie einen Wert aus der Liste aus.

      • Wenn Sie "Keine" ausgewählt haben (ein Freiformtag anwenden), geben Sie einen Tagschlüssel ein, und geben Sie einen Wert ein.

    3. Um ein anderes Tag anzuwenden, wählen Sie die Schaltfläche "Zusätzliches Tag".

      Sie können nicht mehr als ein Tag mit demselben Tag-Namespace und demselben Tagschlüssel für ein definiertes Tag oder mehrere Tags mit demselben Tagschlüssel für ein Freiformtag angeben.

    4. Um die Tags für die Ressource zu prüfen, gehen Sie zur Detailseite für die neue Ressource.

      Wählen Sie auf der Seite mit den Ressourcendetails die Registerkarte "Tags", um die Tags anzuzeigen, die auf diese Ressource angewendet werden.

  • Um einer Ressource beim Erstellen der Ressource ein Tag hinzuzufügen, verwenden Sie den Befehl create oder launch der Ressource.

    1. Rufen Sie die Informationen für jedes Tag ab, das Sie der Ressource hinzufügen möchten.

      • Rufen Sie den Namespace, den Schlüssel und den Wert für jedes definierte Tag ab, das Sie der Ressource hinzufügen möchten.

        Erstellen Sie ein Argument für die Option --defined-tags. Geben Sie jeden Tag-Namespace und jedes Tagschlüsselpaar nur einmal an.

      • Rufen Sie den Schlüssel und den Wert für jedes Freiformtag ab, das Sie der Ressource hinzufügen möchten.

        Erstellen Sie ein Argument für die Option --freeform-tags. Geben Sie jeden Tagschlüssel nur einmal an.

      Der Wert des Optionsarguments --defined-tags und des Optionsarguments --freeform-tags ist eine JSON-Definition der Tags. Diese JSON-Definition kann als Zeichenfolge in der Befehlszeile oder in einer Datei angegeben werden.

      Sie können eine Vorlage mit der richtigen JSON generieren, die Sie bereitstellen möchten, indem Sie die Option --generate-param-json-input mit dem Basisbefehl verwenden, mit dem Sie die Ressource taggen. Das Argument für die Option --generate-param-json-input ist der Name der Option, mit der Sie die Tags (in diesem Beispiel --defined-tags) ohne den Optionsindikator (--) angeben, wie im folgenden Beispiel dargestellt:

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

      Der Inhalt der Ausgabedatei defined_tags.json lautet:

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

      Wenn Sie freeform-tags anstelle von defined-tags im vorherigen Befehl angeben, erhalten Sie die folgende Ausgabe:

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

      Bearbeiten Sie diese Vorlagen, um die entsprechenden Tags bereitzustellen. Geben Sie das Ergebnis im letzten Befehl an, wie im folgenden Schritt gezeigt.

    2. Führen Sie den Befehl create oder launch der Ressource aus.

      Um ein oder mehrere definierte Tags hinzuzufügen, verwenden Sie die Option --defined-tags. Um ein oder mehrere Freiformtags hinzuzufügen, verwenden Sie die Option --freeform-tags.

      Syntax:

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

      Beispiel:

      Im folgenden Beispiel wird ein oder mehrere definierte Tags mit einer Datei hinzugefügt, und ein Freiformtag wird mit einem Zeichenfolgenargument hinzugefügt. Verwenden Sie die file://-Syntax, um eine Datei als Optionsargument anzugeben.

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

      Die Ausgabe des Befehls create oder launch der Ressource entspricht der Ausgabe des Befehls get der Ressource. Die Ausgabe zeigt die definierten Tags und Freiformtags an.

    Eine vollständige Liste der CLI-Befehle, Flags und Optionen finden Sie in der Befehlszeilenreferenz.

  • Um einer Ressource ein Tag hinzuzufügen, wenn Sie die Ressource erstellen, verwenden Sie den Befehl create<resource> oder launch<resource>.

    Informationen zur Verwendung der API und zu Signieranforderungen finden Sie unter REST-APIs und Sicherheitszugangsdaten. Informationen zu SDKs finden Sie unter Software Development Kits und Befehlszeilenschnittstelle (CLI).