Uso de etiquetas para organizar los recursos de Azure y la jerarquía de administración

Artículo
03/25/2023
Tiempo de lectura: 18 minutos

Las etiquetas son elementos de metadatos que se aplican a los recursos de Azure. Son pares clave-valor que le ayudan a identificar los recursos en función de la configuración que sean relevantes para su organización. Si desea realizar un seguimiento del entorno de implementación de los recursos, agregue una clave denominada Entorno. Para identificar los recursos implementados en producción, asígneles un valor de Producción. Totalmente formado, el par clave-valor se convierte en Entorno = Producción.

Aplique etiquetas a los recursos, grupos de recursos y suscripciones de Azure.

Para recomendaciones sobre cómo implementar una estrategia de etiquetado, consulte Guía de decisiones de nomenclatura y etiquetado de recursos.

Las etiquetas de recursos admiten todos los servicios de acumulación de costes. Para asegurarse de que los servicios de acumulación de costos se aprovisionan con una etiqueta, use una de las directivas de etiquetas.

Advertencia

Las etiquetas se almacenan como texto sin formato. Nunca agregue valores sensibles a las etiquetas. Los valores confidenciales se pueden exponer a través de muchos métodos, incluidos informes de costos, comandos que devuelven definiciones de etiquetas existentes, historiales de implementación, plantillas exportadas y registros de supervisión.

Advertencia

Tenga cuidado al usar un idioma que no sea inglés en las etiquetas. Puede provocar un error de progreso de descodificación al cargar los metadatos de la máquina virtual desde IMDS (Instance Metadata Service).

Importante

Las nombres de etiqueta no distinguen mayúsculas de minúsculas para las operaciones. Una etiqueta con un nombre de etiqueta se actualiza o se recupera independientemente del uso de mayúsculas o minúsculas. Sin embargo, el proveedor de recursos podría mantener el uso de mayúsculas y minúsculas para el nombre de la etiqueta. Puede ver dicho uso de mayúsculas y minúsculas en los informes de costos.

Los valores de etiqueta distinguen mayúsculas de minúsculas.

Nota

En este artículo se indican los pasos para eliminar los datos personales del dispositivo o del servicio y puede utilizarse para cumplir con sus obligaciones según el Reglamento general de protección de datos (RGPD). Para obtener información general sobre RGPD, consulte Información sobre los procedimientos recomendados para el cumplimiento del RGPD y la sección RGPD del portal de confianza de servicios.

Acceso necesario

Hay dos maneras de obtener el acceso necesario a los recursos de etiqueta.

Puede tener acceso de escritura al tipo de recurso Microsoft.Resources/tags. Este acceso permite etiquetar cualquier recurso, incluso si no tiene acceso al propio recurso. El rol Colaborador de etiquetas concede este acceso. El rol colaborador de etiquetas no puede aplicar etiquetas a recursos o grupos de recursos a través del portal. Puede aplicar etiquetas a las suscripciones a través del portal. Este admite todas las operaciones de etiqueta a través de Azure PowerShell y la API de REST.
Puede tener acceso de escritura al propio recurso. El rol Colaborador concede el acceso necesario para aplicar etiquetas a cualquier entidad. Para aplicar etiquetas a un solo tipo de recurso, use el rol de colaborador para ese recurso. Para aplicar etiquetas a las máquinas virtuales, por ejemplo, use Colaborador de la máquina virtual.

PowerShell

Aplicación de etiquetas

Azure PowerShell ofrece dos comandos para aplicar etiquetas: New-AzTag y Update-AzTag. Debe tener el módulo Az.Resources versión 1.12.0 o posterior. Puede consultar su versión con Get-InstalledModule -Name Az.Resources. Puede instalar ese módulo o instalar Azure PowerShell versión 3.6.1 o posterior.

New-AzTag 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:

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resource = Get-AzResource -Name demoStorage -ResourceGroup demoGroup
New-AzTag -ResourceId $resource.id -Tag $tags

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

Properties :
        Name    Value
        ======  =======
        Dept    Finance
        Status  Normal

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

$tags = @{"Team"="Compliance"; "Environment"="Production"}
New-AzTag -ResourceId $resource.id -Tag $tags

Properties :
        Name         Value
        ===========  ==========
        Environment  Production
        Team         Compliance

Para agregar etiquetas a un recurso que ya tiene etiquetas, use Update-AzTag. Establezca el parámetro -Operation en Merge.

$tags = @{"Dept"="Finance"; "Status"="Normal"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge

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

Properties :
        Name         Value
        ===========  ==========
        Status       Normal
        Dept         Finance
        Team         Compliance
        Environment  Production

Cada nombre de etiqueta solo puede tener un valor. Si proporciona un valor nuevo para una 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).

$tags = @{"Status"="Green"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge

Properties :
        Name         Value
        ===========  ==========
        Status       Green
        Dept         Finance
        Team         Compliance
        Environment  Production

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

$tags = @{"Project"="ECommerce"; "CostCenter"="00123"; "Team"="Web"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Replace

Solo las etiquetas nuevas siguen en el recurso.

Properties :
        Name        Value
        ==========  =========
        CostCenter  00123
        Team        Web
        Project     ECommerce

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:

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resourceGroup = Get-AzResourceGroup -Name demoGroup
New-AzTag -ResourceId $resourceGroup.ResourceId -tag $tags

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

$tags = @{"CostCenter"="00123"; "Environment"="Production"}
$resourceGroup = Get-AzResourceGroup -Name demoGroup
Update-AzTag -ResourceId $resourceGroup.ResourceId -Tag $tags -Operation Merge

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

$tags = @{"CostCenter"="00123"; "Environment"="Dev"}
$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
New-AzTag -ResourceId "/subscriptions/$subscription" -Tag $tags

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

$tags = @{"Team"="Web Apps"}
$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Update-AzTag -ResourceId "/subscriptions/$subscription" -Tag $tags -Operation Merge

Puede tener más de un recurso con el mismo nombre en un grupo de recursos. En ese caso, puede establecer cada recurso con los siguientes comandos:

$resource = Get-AzResource -ResourceName sqlDatabase1 -ResourceGroupName examplegroup
$resource | ForEach-Object { Update-AzTag -Tag @{ "Dept"="IT"; "Environment"="Test" } -ResourceId $_.ResourceId -Operation Merge }

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

Para ver las etiquetas de un recurso, use:

$resource = Get-AzResource -Name demoStorage -ResourceGroup demoGroup
Get-AzTag -ResourceId $resource.id

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

$resourceGroup = Get-AzResourceGroup -Name demoGroup
Get-AzTag -ResourceId $resourceGroup.ResourceId

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

$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Get-AzTag -ResourceId "/subscriptions/$subscription"

Enumerar por etiqueta

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

(Get-AzResource -Tag @{ "CostCenter"="00123"}).Name

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

(Get-AzResource -TagName "Dept").Name

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

(Get-AzResourceGroup -Tag @{ "CostCenter"="00123" }).ResourceGroupName

Eliminación de etiquetas

Para quitar etiquetas específicas, use Update-AzTag y establezca -Operation en Delete. Pase los identificadores de recursos de las etiquetas que desea eliminar.

$removeTags = @{"Project"="ECommerce"; "Team"="Web"}
Update-AzTag -ResourceId $resource.id -Tag $removeTags -Operation Delete

Se quitan las etiquetas especificadas.

Properties :
        Name        Value
        ==========  =====
        CostCenter  00123

Para quitar todas las etiquetas, use el comando Remove-AzTag.

$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Remove-AzTag -ResourceId "/subscriptions/$subscription"

Azure CLI

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"

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"

Plantillas de ARM

Puede etiquetar recursos, grupos de recursos y suscripciones durante la implementación con una plantilla de Resource Manager.

Nota

Las etiquetas que se aplican mediante la plantilla de ARM o el archivo de Bicep sobrescriben las existentes.

Aplicación de valores

En el ejemplo siguiente se implementa una cuenta de almacenamiento con tres etiquetas. Dos de las etiquetas (Dept y Environment) se establecen en valores literales. Una etiqueta (LastDeployed) se establece en un parámetro que tiene como valor predeterminado la fecha actual.

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "utcShort": {
      "type": "string",
      "defaultValue": "[utcNow('d')]"
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[concat('storage', uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "tags": {
        "Dept": "Finance",
        "Environment": "Production",
        "LastDeployed": "[parameters('utcShort')]"
      },
      "properties": {}
    }
  ]
}

param location string = resourceGroup().location
param utcShort string = utcNow('d')

resource stgAccount 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  name: 'storage${uniqueString(resourceGroup().id)}'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
  tags: {
    Dept: 'Finance'
    Environment: 'Production'
    LastDeployed: utcShort
  }
}

Aplicación de un objeto

Puede definir un parámetro de objeto que almacene varias etiquetas y aplicar ese objeto al elemento de etiqueta. Este enfoque proporciona más flexibilidad que el ejemplo anterior, porque el objeto puede tener propiedades diferentes. Cada propiedad del objeto se convierte en una etiqueta independiente para el recurso. El siguiente ejemplo tiene un parámetro denominado tagValues que se aplica al elemento de etiqueta.

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "tagValues": {
      "type": "object",
      "defaultValue": {
        "Dept": "Finance",
        "Environment": "Production"
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[concat('storage', uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "tags": "[parameters('tagValues')]",
      "properties": {}
    }
  ]
}

param location string = resourceGroup().location
param tagValues object = {
  Dept: 'Finance'
  Environment: 'Production'
}

resource stgAccount 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  name: 'storage${uniqueString(resourceGroup().id)}'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
  tags: tagValues
}

Aplicación de una cadena JSON

Para almacenar muchos valores en una única etiqueta, aplique una cadena JSON que represente los valores. Toda la cadena JSON se almacena como una etiqueta que no puede superar los 256 caracteres. En el ejemplo siguiente se muestra una etiqueta denominada CostCenter que contiene varios valores de una cadena JSON:

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[concat('storage', uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "tags": {
        "CostCenter": "{\"Dept\":\"Finance\",\"Environment\":\"Production\"}"
      },
      "properties": {}
    }
  ]
}

param location string = resourceGroup().location

resource stgAccount 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  name: 'storage${uniqueString(resourceGroup().id)}'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
  tags: {
    CostCenter: '{"Dept":"Finance","Environment":"Production"}'
  }
}

Aplicación de etiquetas del grupo de recursos

Para aplicar etiquetas desde un grupo de recursos a un recurso, use la función resourceGroup(). Cuando obtenga el valor de la etiqueta, use la sintaxis tags[tag-name] en lugar de la sintaxis tags.tag-name, porque algunos caracteres no se analizan correctamente en la notación de puntos.

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[concat('storage', uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "tags": {
        "Dept": "[resourceGroup().tags['Dept']]",
        "Environment": "[resourceGroup().tags['Environment']]"
      },
      "properties": {}
    }
  ]
}

param location string = resourceGroup().location

resource stgAccount 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  name: 'storage${uniqueString(resourceGroup().id)}'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
  tags: {
    Dept: resourceGroup().tags['Dept']
    Environment: resourceGroup().tags['Environment']
  }
}

Aplicación de etiquetas a grupos de recursos o suscripciones

Puede agregar etiquetas a un grupo de recursos o una suscripción mediante la implementación del tipo de recurso Microsoft.Resources/tags. Puede aplicar las etiquetas al grupo de recursos de destino o a la suscripción que desea implementar. Cada vez que implemente la plantilla reemplaza cualquier etiqueta que haya aplicado anteriormente.

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "tagName": {
      "type": "string",
      "defaultValue": "TeamName"
    },
    "tagValue": {
      "type": "string",
      "defaultValue": "AppTeam1"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Resources/tags",
      "name": "default",
      "apiVersion": "2021-04-01",
      "properties": {
        "tags": {
          "[parameters('tagName')]": "[parameters('tagValue')]"
        }
      }
    }
  ]
}

param tagName string = 'TeamName'
param tagValue string = 'AppTeam1'

resource applyTags 'Microsoft.Resources/tags@2021-04-01' = {
  name: 'default'
  properties: {
    tags: {
      '${tagName}': tagValue
    }
  }
}

Para aplicar las etiquetas a un grupo de recursos, use Azure PowerShell o la CLI de Azure. Implemente en el grupo de recursos que quiere etiquetar.

New-AzResourceGroupDeployment -ResourceGroupName exampleGroup -TemplateFile https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

az deployment group create --resource-group exampleGroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

Para aplicar las etiquetas a una suscripción, use PowerShell o la CLI de Azure. Implemente en la suscripción que quiere etiquetar.

New-AzSubscriptionDeployment -name tagresourcegroup -Location westus2 -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

az deployment sub create --name tagresourcegroup --location westus2 --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

Para más información sobre las implementaciones de suscripciones, consulte Creación de grupos de recursos y otros recursos en el nivel de suscripción.

La plantilla siguiente agrega las etiquetas de un objeto a un grupo de recursos o a una suscripción.

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2018-05-01/subscriptionDeploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "tags": {
      "type": "object",
      "defaultValue": {
        "TeamName": "AppTeam1",
        "Dept": "Finance",
        "Environment": "Production"
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Resources/tags",
      "apiVersion": "2021-04-01",
      "name": "default",
      "properties": {
        "tags": "[parameters('tags')]"
      }
    }
  ]
}

targetScope = 'subscription'

param tagObject object = {
  TeamName: 'AppTeam1'
  Dept: 'Finance'
  Environment: 'Production'
}

resource applyTags 'Microsoft.Resources/tags@2021-04-01' = {
  name: 'default'
  properties: {
    tags: tagObject
  }
}

Portal

Si un usuario no tiene el acceso necesario para aplicar etiquetas, puede asignarle el rol Colaborador de etiquetas. Para más información, consulte el Tutorial: Concesión de acceso de usuario a los recursos de Azure mediante RBAC y Azure Portal.

Para ver las etiquetas de un recurso o un grupo de recursos, busque etiquetas existentes en la información general. Si no ha aplicado etiquetas anteriormente, la lista está vacía.
Para agregar una etiqueta, seleccione Haga clic aquí para agregar etiquetas.
Proporcione un nombre y un valor.
Continúe agregando etiquetas según sea necesario. Cuando haya terminado, seleccione Guardar.
Las etiquetas aparecen ahora en la información general.
Para agregar o eliminar una etiqueta, seleccione cambiar.
Para eliminar una etiqueta, seleccione el icono de papelera. Después, seleccione Guardar.

Para asignar etiquetas a varios recursos de forma masiva:

En cualquier lista de recursos, seleccione la casilla de los recursos a los que quiere asignar la etiqueta. Después, seleccione Asignar etiquetas.
Agregue nombres y valores. Cuando haya terminado, seleccione Guardar.

Para ver todos los recursos con una etiqueta:

En el menú de Azure Portal, busque etiquetas. Seleccione el servicio entre las opciones disponibles.
Seleccione la etiqueta para ver los recursos.
Se muestran todos los recursos que contienen esa etiqueta.

API DE REST

Para trabajar con etiquetas a través de la API REST de Azure, use:

Etiquetas: crear o actualizar en el ámbito (operación PUT)
Etiquetas: actualizar en el ámbito (operación PATCH)
Etiquetas: obtener en el ámbito (operación GET)
Etiquetas: eliminar en el ámbito (operación DELETE)

SDK

Para obtener ejemplos de la aplicación de etiquetas con SDK, consulte:

Herencia de etiquetas

Los recursos no heredan las etiquetas que se aplican a un grupo de recursos o a una suscripción. Para aplicar etiquetas de un grupo de recursos o una suscripción a los recursos, consulte Azure Policies: etiquetas.

Etiquetas y facturación

Puede usar etiquetas a fin de agrupar los datos de facturación. Si va a ejecutar varias máquinas virtuales para distintas organizaciones, por ejemplo, use las etiquetas para agrupar la utilización por centro de coste. También puede usar etiquetas para clasificar los costos por entorno de tiempo de ejecución; por ejemplo, el uso de facturación en máquinas virtuales que se ejecutan en el entorno de producción.

Puede recuperar información sobre las etiquetas si descarga el archivo de utilización disponible en Azure Portal. Para más información, consulte Procedimiento para descargar las datos de uso diario y de factura de Azure. En los servicios que admiten etiquetas con facturación, las etiquetas aparecen en la columna Etiquetas.

Para las operaciones de API de REST, vea Referencia de API de REST de facturación de Azure.

Limitaciones

Se aplican las siguientes limitaciones a las etiquetas:

No todos los tipos de recursos admiten etiquetas. Para determinar si se puede aplicar una etiqueta a un tipo de recurso determinado, consulte Tag support for Azure resources (Compatibilidad con etiquetas para los recursos de Azure).
Cada recurso, grupo de recursos y suscripción puede tener un máximo de 50 pares nombre-valor de etiqueta. Si necesita aplicar más etiquetas que el número máximo permitido, use una cadena JSON para el valor de etiqueta. La cadena JSON puede contener muchos valores que se aplican a un solo nombre de etiqueta. Un grupo de recursos o una suscripción puede contener muchos recursos con 50 pares clave-valor de etiqueta cada uno.
El nombre de etiqueta tiene un límite de 512 caracteres y el valor de etiqueta tiene un límite de 256 caracteres. En el caso de las cuentas de almacenamiento, el nombre de etiqueta tiene un límite de 128 caracteres y el valor de etiqueta tiene un límite de 256 caracteres.
Los recursos clásicos, como Cloud Services, no admiten etiquetas.
Azure IP Groups y Azure Firewall Policies no admiten operaciones PATCH. Por lo tanto, las operaciones del método PATCH de API no pueden actualizar etiquetas a través del portal. En su lugar, use los comandos de actualización para esos recursos. Puede actualizar etiquetas para un grupo de direcciones IP, por ejemplo, con el comando az network ip-group update.
Los nombres de etiqueta no pueden contener estos caracteres: <, >, %, &, \, ?, /
Nota
- Las zonas de Azure DNS no admiten el uso de espacios en la etiqueta o una etiqueta que empiece por un número. Los nombres de etiqueta de Azure DNS no admiten caracteres especiales ni Unicode. El valor puede contener todos los caracteres.
- Traffic Manager no admite el uso de espacios, # o : en el nombre de la etiqueta. EL nombre de la etiqueta no puede empezar por un número.
- Azure Front Door no admite el uso de # o : en el nombre de la etiqueta.
- Los siguientes recursos de Azure solo admiten 15 etiquetas:
  - Azure Automation
  - Azure Content Delivery Network
  - Azure DNS (zona y registros A)
  - Búsqueda guardada de Azure Log Analytics

Pasos siguientes

No todos los tipos de recursos admiten etiquetas. Para determinar si se puede aplicar una etiqueta a un tipo de recurso determinado, consulte Tag support for Azure resources (Compatibilidad con etiquetas para los recursos de Azure).
Para recomendaciones sobre cómo implementar una estrategia de etiquetado, consulte Guía de decisiones de nomenclatura y etiquetado de recursos.

Uso de etiquetas para organizar los recursos de Azure y la jerarquía de administración

Acceso necesario

PowerShell

Aplicación de etiquetas

Enumerar por etiqueta

Eliminación de etiquetas

Azure CLI

Aplicación de etiquetas

Enumerar por etiqueta

Eliminación de etiquetas

Control de los espacios

Plantillas de ARM

Aplicación de valores

Aplicación de un objeto

Aplicación de una cadena JSON

Aplicación de etiquetas del grupo de recursos

Aplicación de etiquetas a grupos de recursos o suscripciones

Portal

API DE REST

SDK

Herencia de etiquetas

Etiquetas y facturación

Limitaciones

Pasos siguientes

Recursos adicionales

Recursos adicionales

Uso de etiquetas para organizar los recursos de Azure y la jerarquía de administración

Acceso necesario

PowerShell

Aplicación de etiquetas

Lista de etiquetas

Enumerar por etiqueta

Eliminación de etiquetas

Azure CLI

Aplicación de etiquetas

Lista de etiquetas

Enumerar por etiqueta

Eliminación de etiquetas

Control de los espacios

Plantillas de ARM

Aplicación de valores

Aplicación de un objeto

Aplicación de una cadena JSON

Aplicación de etiquetas del grupo de recursos

Aplicación de etiquetas a grupos de recursos o suscripciones

Portal

API DE REST

SDK

Herencia de etiquetas

Etiquetas y facturación

Limitaciones

Pasos siguientes

Recursos adicionales

Recursos adicionales