Partilhar via

Aplicar etiquetas com o Azure CLI

Este artigo descreve como usar o Azure CLI para marcar recursos, grupos de recursos e subscrições. Para recomendações e limitações de tags, consulte Usar tags para organizar os seus recursos Azure e hierarquia de gestão.

Aplicar tags

O Azure CLI oferece dois comandos para aplicar tags: az tag create e az tag update. Precisas de ter a versão Azure CLI 2.10.0 ou posterior. Pode verificar a sua versão com az version. Para atualizar ou instalar, consulte Instalar a CLI do Azure.

Substitui az tag create todas as etiquetas no recurso, grupo de recursos ou subscrição. Quando chamar o comando, passe o ID do recurso da entidade que quer 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 termina, repare que o recurso tem duas etiquetas.

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

Se executares o comando novamente, mas desta vez com etiquetas diferentes, repara que as etiquetas anteriores desaparecem.

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

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

Para adicionar tags a um recurso que já tem tags, use 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 crescem com a adição das duas novas etiquetas.

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

Cada nome de etiqueta pode ter apenas um valor. Se fornecer um novo valor para uma etiqueta, a nova etiqueta substitui o valor antigo, mesmo que use a operação de fusã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 defines o --operation parâmetro para 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. Passa-os no identificador do grupo de recursos ou subscrição que queres identificar.

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, use o comando az tag list e passe o ID de recurso da entidade.

Para ver as etiquetas de um recurso, use:

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, use:

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

Lista por etiqueta

Para obter recursos que tenham 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 que tenham um nome e valor de etiqueta específicos, utilize:

az group list --tag Dept=Finance

Remover tags

Para remover etiquetas específicas, use az tag update e defina --operation para Delete. Passa o ID do recurso das etiquetas que queres apagar.

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

Removeste as etiquetas especificadas.

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

Para remover todas as etiquetas, use o comando delete de etiquetas do az .

az tag delete --resource-id $resource

Espaços de tratamento

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

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

Próximos passos

  • Last updated on