Dela via

Använda taggar med Azure CLI

  • Artikel

I den här artikeln beskrivs hur du använder Azure CLI för att tagga resurser, resursgrupper och prenumerationer. Taggrekommendationer och begränsningar finns i Använda taggar för att organisera dina Azure-resurser och hanteringshierarki.

Använda taggar

Azure CLI erbjuder två kommandon för att tillämpa taggar: az tag create och az tag update. Du måste ha Azure CLI 2.10.0-versionen eller senare. Du kan kontrollera din version med az version. Information om hur du uppdaterar eller installerar det finns i Installera Azure CLI.

az tag create ersätter alla taggar för resursen, resursgruppen eller prenumerationen. När du anropar kommandot skickar du resurs-ID:t för den entitet som du vill tagga.

I följande exempel tillämpas en uppsättning taggar på ett lagringskonto:

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

När kommandot har slutförts ser du att resursen har två taggar.

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

Om du kör kommandot igen, men den här gången med olika taggar, ser du att de tidigare taggarna försvinner.

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

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

Om du vill lägga till taggar till en resurs som redan har taggar använder du az tag update. Ange parametern --operation till Merge.

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

Observera att de befintliga taggarna växer med tillägg av de två nya taggarna.

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

Varje taggnamn kan bara ha ett värde. Om du anger ett nytt värde för en tagg ersätter den nya taggen det gamla värdet, även om du använder sammanslagningsåtgärden. I följande exempel ändras taggen Status från Normal till Grön.

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

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

När du anger parametern --operation till Replaceersätter den nya uppsättningen taggar de befintliga taggarna.

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

Endast de nya taggarna finns kvar på resursen.

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

Samma kommandon fungerar också med resursgrupper eller prenumerationer. Skicka dem i identifieraren för den resursgrupp eller prenumeration som du vill tagga.

Om du vill lägga till en ny uppsättning taggar i en resursgrupp använder du:

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

Om du vill uppdatera taggarna för en resursgrupp använder du:

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

Om du vill lägga till en ny uppsättning taggar i en prenumeration använder du:

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

Om du vill uppdatera taggarna för en prenumeration använder du:

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

Visa en lista över taggar

Om du vill hämta taggarna för en resurs, resursgrupp eller prenumeration använder du kommandot az tag list och skickar resurs-ID:t för entiteten.

Om du vill se taggarna för en resurs använder du:

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

Om du vill se taggarna för en resursgrupp använder du:

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

Om du vill se taggarna för en prenumeration använder du:

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

Lista efter tagg

Om du vill hämta resurser som har ett specifikt taggnamn och värde använder du:

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

Om du vill hämta resurser som har ett specifikt taggnamn med valfritt taggvärde använder du:

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

Om du vill hämta resursgrupper som har ett specifikt taggnamn och värde använder du:

az group list --tag Dept=Finance

Ta bort taggar

Om du vill ta bort specifika taggar använder az tag update du och anger --operation till Delete. Skicka resurs-ID:t för de taggar som du vill ta bort.

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

Du har tagit bort de angivna taggarna.

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

Om du vill ta bort alla taggar använder du kommandot az tag delete .

az tag delete --resource-id $resource

Hantera blanksteg

Om dina taggnamn eller värden innehåller blanksteg omger du dem inom citattecken.

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

Nästa steg