Tags toepassen met Azure CLI

  • Artikel

In dit artikel wordt beschreven hoe u Azure CLI gebruikt om resources, resourcegroepen en abonnementen te taggen. Zie Tags gebruiken om uw Azure-resources en -beheerhiërarchie te organiseren voor aanbevelingen en beperkingen voor tags.

Tags toepassen

Azure CLI biedt twee opdrachten om tags toe te passen: az tag create en az tag update. U moet de Azure CLI 2.10.0-versie of hoger hebben. U kunt uw versie controleren met az version. Zie De Azure CLI installeren om deze bij te werken of te installeren.

De az tag create vervangt alle tags in de resource, resourcegroep of het abonnement. Wanneer u de opdracht aanroept, geeft u de resource-id door van de entiteit die u wilt taggen.

In het volgende voorbeeld wordt een set tags toegepast op een opslagaccount:

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

Wanneer de opdracht is voltooid, ziet u dat de resource twee tags heeft.

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

Als u de opdracht opnieuw uitvoert, maar deze keer met verschillende tags, ziet u dat de eerdere tags verdwijnen.

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

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

Als u tags wilt toevoegen aan een resource die al tags bevat, gebruikt u az tag update. Stel de --operation parameter in op Merge.

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

U ziet dat de bestaande tags groter worden met de toevoeging van de twee nieuwe tags.

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

Elke tagnaam kan slechts één waarde hebben. Als u een nieuwe waarde opgeeft voor een tag, vervangt de nieuwe tag de oude waarde, zelfs als u de samenvoegbewerking gebruikt. In het volgende voorbeeld wordt de Status tag gewijzigd van Normaal in Groen.

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

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

Wanneer u de --operation parameter instelt op Replace, vervangt de nieuwe set tags de bestaande tags.

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

Alleen de nieuwe tags blijven over in de resource.

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

Dezelfde opdrachten werken ook met resourcegroepen of abonnementen. Geef ze door in de id van de resourcegroep of het abonnement dat u wilt taggen.

Als u een nieuwe set tags wilt toevoegen aan een resourcegroep, gebruikt u:

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

Als u de tags voor een resourcegroep wilt bijwerken, gebruikt u:

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

Als u een nieuwe set tags wilt toevoegen aan een abonnement, gebruikt u:

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

Als u de tags voor een abonnement wilt bijwerken, gebruikt u:

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

Tags weergeven

Als u de tags voor een resource, resourcegroep of abonnement wilt ophalen, gebruikt u de opdracht az tag list en geeft u de resource-id van de entiteit door.

Als u de tags voor een resource wilt zien, gebruikt u:

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

Als u de tags voor een resourcegroep wilt zien, gebruikt u:

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

Als u de tags voor een abonnement wilt zien, gebruikt u:

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

Lijst op label

Als u resources met een specifieke tagnaam en -waarde wilt ophalen, gebruikt u:

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

Als u resources wilt ophalen met een specifieke tagnaam met een tagwaarde, gebruikt u:

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

Als u resourcegroepen wilt ophalen die een specifieke tagnaam en -waarde hebben, gebruikt u:

az group list --tag Dept=Finance

Tags verwijderen

Als u specifieke tags wilt verwijderen, gebruikt az tag update u en stelt u in --operation op Delete. Geef de resource-id door van de tags die u wilt verwijderen.

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

U hebt de opgegeven tags verwijderd.

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

Als u alle tags wilt verwijderen, gebruikt u de opdracht az tag delete .

az tag delete --resource-id $resource

Verwerkingsruimten

Als uw tagnamen of -waarden spaties bevatten, plaatst u deze tussen aanhalingstekens.

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

Volgende stappen