Partilhar via

Aplicar etiquetas com a CLI do Azure

  • Artigo

Este artigo descreve como utilizar a CLI do Azure para etiquetar recursos, grupos de recursos e subscrições. Para obter recomendações e limitações de etiquetas, veja Utilizar etiquetas para organizar os recursos e a hierarquia de gestão do Azure.

Aplicar etiquetas

A CLI do Azure oferece dois comandos para aplicar etiquetas: az tag create e az tag update. Tem de ter a versão 2.10.0 da CLI do Azure ou posterior. Pode verificar a sua versão com az version. Para o atualizar ou instalar, veja Instalar a CLI do Azure.

O az tag create substitui todas as etiquetas no recurso, grupo de recursos ou subscrição. Quando chamar o comando, transmita o ID de recurso da entidade que pretende etiquetar.

O exemplo seguinte aplica um conjunto de etiquetas a uma conta de armazenamento:

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

Quando o comando for concluído, repare que o recurso tem duas etiquetas.

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

Se voltar a executar o comando, mas desta vez com etiquetas diferentes, repare que as etiquetas anteriores desaparecem.

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

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

Para adicionar etiquetas a um recurso que já tenha etiquetas, utilize az tag update. Defina o --operation parâmetro como Merge.

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

Repare que as etiquetas existentes aumentam com a adição das duas novas etiquetas.

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

Cada nome de etiqueta só pode ter um valor. Se fornecer um novo valor para uma etiqueta, a nova etiqueta substitui o valor antigo, mesmo que utilize a operação de intercalação. O exemplo seguinte altera a Status etiqueta de Normal para Verde.

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

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

Quando define o --operation parâmetro como Replace, o novo conjunto de etiquetas substitui as etiquetas existentes.

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

Apenas as novas etiquetas permanecem no recurso.

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

Os mesmos comandos também funcionam com grupos de recursos ou subscrições. Transmita-os no identificador do grupo de recursos ou subscrição que pretende etiquetar.

Para adicionar um novo conjunto de etiquetas a um grupo de recursos, utilize:

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

Para atualizar as etiquetas de um grupo de recursos, utilize:

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

Para adicionar um novo conjunto de etiquetas a uma subscrição, utilize:

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

Para atualizar as etiquetas de uma subscrição, utilize:

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

Listar etiquetas

Para obter as etiquetas de um recurso, grupo de recursos ou subscrição, utilize o comando az tag list e transmita o ID de recurso da entidade.

Para ver as etiquetas de um recurso, utilize:

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

Para ver as etiquetas de um grupo de recursos, utilize:

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

Para ver as etiquetas de uma subscrição, utilize:

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

Listar por etiqueta

Para obter recursos com um nome e valor de etiqueta específicos, utilize:

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

Para obter recursos que tenham um nome de etiqueta específico com qualquer valor de etiqueta, utilize:

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

Para obter grupos de recursos com um nome e valor de etiqueta específicos, utilize:

az group list --tag Dept=Finance

Remover etiquetas

Para remover etiquetas específicas, utilize az tag update e defina --operation como Delete. Transmita o ID de recurso das etiquetas que pretende eliminar.

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

Removeu as etiquetas especificadas.

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

Para remover todas as etiquetas, utilize o comando az tag delete .

az tag delete --resource-id $resource

Processar espaços

Se os nomes ou valores das etiquetas incluírem espaços, coloque-os entre aspas.

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

Passos seguintes