Aplicar etiquetas con la CLI de Azure

  • Artículo

En este artículo se describe cómo usar la CLI de Azure para etiquetar recursos, grupos de recursos y suscripciones. Para conocer las limitaciones y recomendaciones de las etiquetas, consulte Uso de etiquetas para organizar los recursos de Azure y jerarquía de administración.

Aplicación de etiquetas

La CLI de Azure ofrece dos comandos para aplicar etiquetas: az tag create y az tag update. Debe tener la CLI de Azure versión 2.10.0 o posterior. Puede consultar su versión con az version. Para actualizarla o instalarla, consulte Instalación de la CLI de Azure.

az tag create reemplaza todas las etiquetas en el recurso, el grupo de recursos o la suscripción. Al llamar al comando, pase el id. de recurso de la entidad que desea etiquetar.

En el ejemplo siguiente se aplica un conjunto de etiquetas a una cuenta de almacenamiento:

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

Cuando se complete el comando, observe que el recurso tiene dos etiquetas.

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

Si vuelve a ejecutar el comando, pero esta vez con etiquetas diferentes, observe que las etiquetas anteriores desaparecen.

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

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

Para agregar etiquetas a un recurso que ya tiene etiquetas, use az tag update. Establezca el parámetro --operation en Merge.

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

Observe que las etiquetas existentes crecen con la adición de las dos nuevas etiquetas.

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

Cada nombre de etiqueta solo puede tener un valor. Si proporciona un valor nuevo para una etiqueta, la nueva etiqueta reemplaza el valor anterior incluso si se usa la operación de combinación. En el ejemplo siguiente la etiqueta Status cambia de Normal a Green (Verde).

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

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

Al establecer el parámetro --operation en Replace, el nuevo conjunto de etiquetas reemplaza a las etiquetas existentes.

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

Solo las etiquetas nuevas siguen en el recurso.

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

Los mismos comandos también funcionan con grupos de recursos o suscripciones. Páselos en el identificador del grupo de recursos o de la suscripción que quiere etiquetar.

Para agregar un nuevo conjunto de etiquetas a un grupo de recursos, use:

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

Para actualizar las etiquetas de un grupo de recursos, use:

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

Para agregar un nuevo conjunto de etiquetas a una suscripción, use:

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

Para actualizar las etiquetas de una suscripción, use:

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

Lista de etiquetas

Para obtener las etiquetas de un recurso, un grupo de recursos o una suscripción, use el comando az tag list y pase el id. de recurso de la entidad.

Para ver las etiquetas de un 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 las etiquetas de un grupo de recursos, use:

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

Para ver las etiquetas de una suscripción, use:

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

Enumerar por etiqueta

Para obtener recursos que tengan un nombre y valor de etiqueta específicos, use:

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

Para obtener recursos que tengan un nombre de etiqueta específico y cualquier valor de etiqueta, use:

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

Para obtener grupos de recursos que tengan un nombre y valor de etiqueta específicos, use:

az group list --tag Dept=Finance

Eliminación de etiquetas

Para quitar etiquetas específicas, use az tag update y establezca --operation en Delete. Pase el identificador de recurso de las etiquetas que desea eliminar.

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

Ha quitado las etiquetas especificadas.

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

Para quitar todas las etiquetas, use el comando az tag delete.

az tag delete --resource-id $resource

Control de los espacios

Si los nombres o valores de etiqueta incluyen espacios, escríbalos entre comillas dobles.

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

Pasos siguientes