Freigeben über

Anwenden von Tags mit Azure CLI

In diesem Artikel wird beschrieben, wie Sie Mithilfe der Azure CLI Ressourcen, Ressourcengruppen und Abonnements kategorisieren. Für Empfehlungen und Einschränkungen von Tags siehe Verwenden von Tags zum Organisieren Ihrer Azure-Ressourcen und der Verwaltungshierarchie.

Tags anwenden

Azure CLI bietet zwei Befehle zum Anwenden von Tags: az tag create and az tag update. Sie müssen über die Azure CLI 2.10.0-Version oder höher verfügen. Sie können Ihre Version überprüfen mit az version. Informationen zum Aktualisieren oder Installieren finden Sie unter Installieren der Azure CLI.

Dies az tag create ersetzt alle Tags für die Ressource, die Ressourcengruppe oder das Abonnement. Wenn Sie den Befehl aufrufen, übergeben Sie die Ressourcen-ID der Entität, die Sie kategorisieren möchten.

Im folgenden Beispiel wird eine Reihe von Tags auf ein Speicherkonto angewendet:

resource=$(az resource show -g demoGroup -n demostorage --resource-type Microsoft.Storage/storageAccounts --query "id" --output tsv)
az tag create --resource-id $resource --tags Dept=Finance Status=Normal

Wenn der Befehl abgeschlossen ist, beachten Sie, dass die Ressource über zwei Tags verfügt.

"properties": {
  "tags": {
    "Dept": "Finance",
    "Status": "Normal"
  }
},

Wenn Sie den Befehl erneut ausführen, aber diesmal mit verschiedenen Tags, beachten Sie, dass die früheren Tags ausgeblendet werden.

az tag create --resource-id $resource --tags Team=Compliance Environment=Production

"properties": {
  "tags": {
    "Environment": "Production",
    "Team": "Compliance"
  }
},

Verwenden Sie az tag updatezum Hinzufügen von Tags zu einer Ressource, die bereits Tags enthält. Setzen Sie den --operation-Parameter auf Merge.

az tag update --resource-id $resource --operation Merge --tags Dept=Finance Status=Normal

Beachten Sie, dass die vorhandenen Tags mit dem Hinzufügen der beiden neuen Tags wachsen.

"properties": {
  "tags": {
    "Dept": "Finance",
    "Environment": "Production",
    "Status": "Normal",
    "Team": "Compliance"
  }
},

Jeder Tagname darf nur einen Wert aufweisen. Wenn Sie einen neuen Wert für ein Tag angeben, ersetzt das neue Tag den alten Wert, auch wenn Sie den Zusammenführungsvorgang verwenden. Im folgenden Beispiel wird das Status-Tag von „Normal“ in „Grün“ geändert.

az tag update --resource-id $resource --operation Merge --tags Status=Green

"properties": {
  "tags": {
    "Dept": "Finance",
    "Environment": "Production",
    "Status": "Green",
    "Team": "Compliance"
  }
},

Wenn Sie den --operation Parameter auf Replace festlegen, ersetzt der neue Satz von Tags die vorhandenen Tags.

az tag update --resource-id $resource --operation Replace --tags Project=ECommerce CostCenter=00123 Team=Web

Nur die neuen Tags verbleiben in der Ressource.

"properties": {
  "tags": {
    "CostCenter": "00123",
    "Project": "ECommerce",
    "Team": "Web"
  }
},

Dieselben Befehle funktionieren auch mit Ressourcengruppen oder Abonnements. Geben Sie sie im Bezeichner der Ressourcengruppe oder des Abonnements an, die Sie taggen möchten.

Wenn Sie einer Ressourcengruppe einen neuen Satz von Tags hinzufügen möchten, verwenden Sie Folgendes:

group=$(az group show -n demoGroup --query id --output tsv)
az tag create --resource-id $group --tags Dept=Finance Status=Normal

Um die Tags für eine Ressourcengruppe zu aktualisieren, verwenden Sie Folgendes:

az tag update --resource-id $group --operation Merge --tags CostCenter=00123 Environment=Production

Wenn Sie einem Abonnement einen neuen Satz von Tags hinzufügen möchten, verwenden Sie Folgendes:

sub=$(az account show --subscription "Demo Subscription" --query id --output tsv)
az tag create --resource-id /subscriptions/$sub --tags CostCenter=00123 Environment=Dev

Um die Tags für ein Abonnement zu aktualisieren, verwenden Sie Folgendes:

az tag update --resource-id /subscriptions/$sub --operation Merge --tags Team="Web Apps"

Auflisten von Tags

Um die Tags für eine Ressource, eine Ressourcengruppe oder ein Abonnement abzurufen, verwenden Sie den Befehl "az-Tagliste" , und übergeben Sie die Ressourcen-ID der Entität.

Um die Tags für eine Ressource anzuzeigen, verwenden Sie Folgendes:

resource=$(az resource show -g demoGroup -n demostorage --resource-type Microsoft.Storage/storageAccounts --query "id" --output tsv)
az tag list --resource-id $resource

Um die Tags für eine Ressourcengruppe anzuzeigen, verwenden Sie Folgendes:

group=$(az group show -n demoGroup --query id --output tsv)
az tag list --resource-id $group

Um die Tags für ein Abonnement anzuzeigen, verwenden Sie Folgendes:

sub=$(az account show --subscription "Demo Subscription" --query id --output tsv)
az tag list --resource-id /subscriptions/$sub

Nach Tags sortieren

Verwenden Sie Folgendes, um Ressourcen mit einem bestimmten Tagnamen und -wert abzurufen:

az resource list --tag CostCenter=00123 --query [].name

Um Ressourcen mit einem bestimmten Tagnamen mit einem beliebigen Tagwert abzurufen, verwenden Sie Folgendes:

az resource list --tag Team --query [].name

Verwenden Sie Folgendes, um Ressourcengruppen mit einem bestimmten Tagnamen und -wert abzurufen:

az group list --tag Dept=Finance

Entfernen von Tags

Um bestimmte Tags zu entfernen, verwenden Sie den Befehl az tag update, und legen Sie --operation auf Delete fest. Übergeben Sie die Ressourcen-ID der Zu löschenden Tags.

az tag update --resource-id $resource --operation Delete --tags Project=ECommerce Team=Web

Sie haben die angegebenen Tags entfernt.

"properties": {
  "tags": {
    "CostCenter": "00123"
  }
},

Verwenden Sie den Befehl zum Löschen des Az-Tags , um alle Tags zu entfernen.

az tag delete --resource-id $resource

Behandeln von Leerzeichen

Wenn Ihre Tagnamen oder -werte Leerzeichen enthalten, schließen Sie sie in Anführungszeichen ein.

az tag update --resource-id $group --operation Merge --tags "Cost Center"=Finance-1222 Location="West US"

Nächste Schritte

  • Last updated on