Anwenden von Tags mit der Azure CLI

  • Artikel

Dieser Artikel beschreibt, wie Sie Azure CLI verwenden, um Ressourcen, Ressourcengruppen und Abonnements zu markieren. Weitere Informationen zu Azure-Tag-Empfehlungen und -Einschränkungen finden Sie unter Verwenden von Tags zur Organisation Ihrer Azure-Ressourcen und der Verwaltungshierarchie.

Anwenden von Tags

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

Mit dem Befehl az tag create werden alle Tags für die Ressource, die Ressourcengruppe oder das Abonnement ersetzt. Übergeben Sie beim Aufrufen des Befehls die Ressourcen-ID der Entität, die markiert werden soll.

Im folgenden Beispiel wird eine Gruppe von Tags auf ein Speicherkonto angewandt:

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

Beachten Sie, dass die Ressource nach Abschluss des Befehls zwei Tags enthält.

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

Wenn Sie den Befehl erneut ausführen, jedoch dieses Mal mit anderen Tags, werden Sie feststellen, dass die früheren Tags verschwinden.

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

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

Um einer Ressource, die bereits Tags enthält, Tags hinzuzufügen, verwenden Sie az tag update. 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 der Ergänzung der beiden neuen Tags wachsen.

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

Jeder Tagname kann nur einen Wert enthalten. Wenn Sie einen neuen Wert für ein Tag angeben, ersetzt der neue Tag den alten Wert auch dann, wenn Sie den Zusammenführungsvorgang verwenden. Im folgenden Beispiel wird das Tag Status von Normal in Green 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 Parameter --operation auf Replace festlegen, werden die vorhandenen Tags durch die neue Gruppe von Tags ersetzt.

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"
  }
},

Diese Befehle können auch für Ressourcengruppen und Abonnements verwendet werden. Übergeben Sie den Bezeichner für die Ressourcengruppe oder das Abonnement, die Sie markieren möchten.

Verwenden Sie zum Hinzufügen einer neuen Gruppe von Tags zu einer Ressourcengruppe Folgendes:

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

Verwenden Sie zum Aktualisieren der Tags für eine Ressourcengruppe Folgendes:

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

Verwenden Sie zum Hinzufügen einer neuen Gruppe von Tags zu einem Abonnement Folgendes:

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

Verwenden Sie zum Aktualisieren der Tags für ein Abonnement 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 tag list, und übergeben Sie die Ressourcen-ID für die Entität.

Verwenden Sie zum Anzeigen der Tags für eine Ressource Folgendes:

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

Verwenden Sie zum Anzeigen der Tags für eine Ressourcengruppe Folgendes:

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

Verwenden Sie zum Anzeigen der Tags für ein Abonnement Folgendes:

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

Auflisten nach Tag

Verwenden Sie zum Abrufen von Ressourcen mit einem bestimmten Tagnamen und -wert Folgendes:

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

Verwenden Sie zum Abrufen von Ressourcen mit einem bestimmten Tagnamen und einem beliebigen Tagwert Folgendes:

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

Verwenden Sie zum Abrufen von Ressourcengruppen mit einem bestimmten Tagnamen und -wert Folgendes:

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 Tags, die Sie löschen möchten.

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

Sie haben die angegebenen Tags entfernt.

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

Um alle Tags zu entfernen, verwenden Sie den Befehl az tag delete.

az tag delete --resource-id $resource

Behandeln von Leerzeichen

Wenn die Tagnamen oder -werte Leerzeichen enthalten, umschließen Sie sie mit Anführungszeichen.

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

Nächste Schritte