Condividi tramite

Applicare tag con l'interfaccia della riga di comando di Azure

  • Articolo

Questo articolo descrive come usare l'interfaccia della riga di comando di Azure per contrassegnare risorse, gruppi di risorse e sottoscrizioni. Per suggerimenti e limitazioni dei tag, vedere Usare i tag per organizzare le risorse di Azure e la gerarchia di gestione.

Applicare tag

L'interfaccia della riga di comando di Azure offre due comandi per applicare tag: az tag create e az tag update. È necessario disporre dell'interfaccia della riga di comando di Azure 2.10.0 o versione successiva. È possibile controllare la versione con az version. Per aggiornarlo o installarlo, vedere Installare l'interfaccia della riga di comando di Azure.

Sostituisce az tag create tutti i tag nella risorsa, nel gruppo di risorse o nella sottoscrizione. Quando si chiama il comando, passare l'ID risorsa dell'entità da contrassegnare.

L'esempio seguente applica un set di tag a un account di archiviazione:

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

Al termine del comando, si noti che la risorsa ha due tag.

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

Se si esegue di nuovo il comando, ma questa volta con tag diversi, si noti che i tag precedenti scompaiono.

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

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

Per aggiungere tag a una risorsa che dispone già di tag, usare az tag update. Impostare il parametro --operation su Merge.

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

Si noti che i tag esistenti crescono con l'aggiunta dei due nuovi tag.

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

Ogni nome di tag può avere un solo valore. Se si specifica un nuovo valore per un tag, il nuovo tag sostituisce il valore precedente, anche se si usa l'operazione di unione. Nell'esempio seguente viene modificato il Status tag da Normal a Green.

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

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

Quando si imposta il --operation parametro su Replace, il nuovo set di tag sostituisce i tag esistenti.

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

Solo i nuovi tag rimangono nella risorsa.

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

Gli stessi comandi funzionano anche con gruppi di risorse o sottoscrizioni. Passarli nell'identificatore del gruppo di risorse o della sottoscrizione da contrassegnare.

Per aggiungere un nuovo set di tag a un gruppo di risorse, usare:

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

Per aggiornare i tag per un gruppo di risorse, usare:

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

Per aggiungere un nuovo set di tag a una sottoscrizione, usare:

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

Per aggiornare i tag per una sottoscrizione, usare:

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

Elencare tag

Per ottenere i tag per una risorsa, un gruppo di risorse o una sottoscrizione, usare il comando az tag list e passare l'ID risorsa dell'entità.

Per visualizzare i tag per una risorsa, usare:

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

Per visualizzare i tag per un gruppo di risorse, usare:

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

Per visualizzare i tag per una sottoscrizione, usare:

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

Elenco per tag

Per ottenere risorse con un nome e un valore di tag specifici, usare:

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

Per ottenere risorse con un nome di tag specifico con qualsiasi valore di tag, usare:

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

Per ottenere gruppi di risorse con un nome e un valore di tag specifici, usare:

az group list --tag Dept=Finance

Rimuovere i tag

Per rimuovere tag specifici, usare az tag update e impostare --operation su Delete. Passare l'ID risorsa dei tag da eliminare.

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

Sono stati rimossi i tag specificati.

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

Per rimuovere tutti i tag, usare il comando az tag delete .

az tag delete --resource-id $resource

Gestione degli spazi

Se i nomi dei tag o i valori includono spazi, racchiuderli tra virgolette.

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

Passaggi successivi