Uso de etiquetas para organizar los recursos de Azure y la jerarquía de administraciónUse tags to organize your Azure resources and management hierarchy

Puede aplicar etiquetas a los recursos, grupos de recursos y suscripciones de Azure con el fin de organizarlos de manera lógica en una taxonomía.You apply tags to your Azure resources, resource groups, and subscriptions to logically organize them into a taxonomy. Cada etiqueta consta de un nombre y un par de valores.Each tag consists of a name and a value pair. Por ejemplo, puede aplicar el nombre "Environment" y el valor "Production" a todos los recursos en producción.For example, you can apply the name "Environment" and the value "Production" to all the resources in production.

Para recomendaciones sobre cómo implementar una estrategia de etiquetado, consulte Guía de decisiones de nomenclatura y etiquetado de recursos.For recommendations on how to implement a tagging strategy, see Resource naming and tagging decision guide.

Importante

Las nombres de etiqueta no distinguen mayúsculas de minúsculas para las operaciones.Tag names are case-insensitive for operations. Una etiqueta con un nombre de etiqueta, independientemente del uso de mayúsculas o minúsculas, se actualiza o se recupera.A tag with a tag name, regardless of casing, is updated or retrieved. Sin embargo, el proveedor de recursos podría mantener el uso de mayúsculas y minúsculas para el nombre de la etiqueta.However, the resource provider might keep the casing you provide for the tag name. Puede ver dicho uso de mayúsculas y minúsculas en los informes de costos.You'll see that casing in cost reports.

Los valores de etiqueta distinguen mayúsculas de minúsculas.Tag values are case-sensitive.

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).This article provides steps for how to delete personal data from the device or service and can be used to support your obligations under the GDPR. Si quiere obtener información general sobre este reglamento, vea la sección del RGPD del Portal de confianza de servicios.If you’re looking for general info about GDPR, see the GDPR section of the Service Trust portal.

Acceso necesarioRequired access

Hay dos maneras de obtener el acceso necesario a los recursos de etiqueta.There are two ways to get the required access to tag resources.

  • Puede tener acceso de escritura al tipo de recurso Microsoft.Resources/tags.You can have write access to the Microsoft.Resources/tags resource type. Este acceso permite etiquetar cualquier recurso, incluso si no tiene acceso al propio recurso.This access lets you tag any resource, even if you don't have access to the resource itself. El rol Colaborador de etiquetas concede este acceso.The Tag Contributor role grants this access. Actualmente, el rol colaborador de etiquetas no puede aplicar etiquetas a recursos o grupos de recursos a través del portal.Currently, the tag contributor role can't apply tags to resources or resource groups through the portal. Puede aplicar etiquetas a las suscripciones a través del portal.It can apply tags to subscriptions through the portal. Este admite todas las operaciones de etiqueta a través de PowerShell y la API REST.It supports all tag operations through PowerShell and REST API.

  • Puede tener acceso de escritura al propio recurso.You can have write access to the resource itself. El rol Colaborador concede el acceso necesario para aplicar etiquetas a cualquier entidad.The Contributor role grants the required access to apply tags to any entity. Para aplicar etiquetas a un solo tipo de recurso, use el rol de colaborador para ese recurso.To apply tags to only one resource type, use the contributor role for that resource. Por ejemplo, para aplicar etiquetas a las máquinas virtuales, use Colaborador de la máquina virtual.For example, to apply tags to virtual machines, use the Virtual Machine Contributor.

PowerShellPowerShell

Aplicación de etiquetasApply tags

Azure PowerShell ofrece dos comandos para aplicar etiquetas: New-AzTag y Update-AzTag.Azure PowerShell offers two commands for applying tags - New-AzTag and Update-AzTag. Debe tener el módulo Az.Resources 1.12.0 o una versión posterior.You must have the Az.Resources module 1.12.0 or later. Puede consultar su versión con Get-Module Az.Resources.You can check your version with Get-Module Az.Resources. Puede instalar ese módulo o Azure PowerShell 3.6.1 o una versión posterior.You can install that module or install Azure PowerShell 3.6.1 or later.

New-AzTag reemplaza todas las etiquetas en el recurso, el grupo de recursos o la suscripción.The New-AzTag replaces all tags on the resource, resource group, or subscription. Al llamar al comando, pase el id. de recurso de la entidad que desea etiquetar.When calling the command, pass in the resource ID of the entity you wish to tag.

En el ejemplo siguiente se aplica un conjunto de etiquetas a una cuenta de almacenamiento:The following example applies a set of tags to a storage account:

$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.When the command completes, notice that the resource has two tags.

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

Si vuelve a ejecutar el comando, pero esta vez con etiquetas diferentes, observe que se quitaron las etiquetas anteriores.If you run the command again but this time with different tags, notice that the earlier tags are removed.

$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.To add tags to a resource that already has tags, use Update-AzTag. Establezca el parámetro -Operation en Merge.Set the -Operation parameter to Merge.

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

Observe que las dos etiquetas nuevas se agregaron a las dos etiquetas existentes.Notice that the two new tags were added to the two existing tags.

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

Cada nombre de etiqueta solo puede tener un valor.Each tag name can have only one value. Si proporciona un valor nuevo para una etiqueta, el valor anterior se reemplaza incluso si se usa la operación de combinación.If you provide a new value for a tag, the old value is replaced even if you use the merge operation. En el ejemplo siguiente se cambia la etiqueta Status (Estado) de Normal a Green (Verde).The following example changes the Status tag from Normal to Green.

$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.When you set the -Operation parameter to Replace, the existing tags are replaced by the new set of tags.

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

Solo las etiquetas nuevas siguen en el recurso.Only the new tags remain on the resource.

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

Los mismos comandos también funcionan con grupos de recursos o suscripciones.The same commands also work with resource groups or subscriptions. Puede pasar el identificador del grupo de recursos o de la suscripción que quiere etiquetar.You pass in the identifier for the resource group or subscription you want to tag.

Para agregar un nuevo conjunto de etiquetas a un grupo de recursos, use:To add a new set of tags to a resource group, 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:To update the tags for a resource group, 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:To add a new set of tags to a subscription, 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:To update the tags for a subscription, 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.You may have more than one resource with the same name in a resource group. En ese caso, puede establecer cada recurso con los siguientes comandos:In that case, you can set each resource with the following commands:

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

Lista de etiquetasList tags

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.To get the tags for a resource, resource group, or subscription, use the Get-AzTag command and pass in the resource ID for the entity.

Para ver las etiquetas de un recurso, use:To see the tags for a resource, use:

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

Para ver las etiquetas de un grupo de recursos, use:To see the tags for a resource group, use:

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

Para ver las etiquetas de una suscripción, use:To see the tags for a subscription, use:

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

Enumerar por etiquetaList by tag

Para obtener recursos que tengan un nombre y valor de etiqueta específicos, use:To get resources that have a specific tag name and value, use:

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

Para obtener recursos que tengan un nombre de etiqueta específico y cualquier valor de etiqueta, use:To get resources that have a specific tag name with any tag value, use:

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

Para obtener grupos de recursos que tengan un nombre y valor de etiqueta específicos, use:To get resource groups that have a specific tag name and value, use:

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

Eliminación de etiquetasRemove tags

Para quitar etiquetas específicas, use Update-AzTag y establezca -Operation en Delete.To remove specific tags, use Update-AzTag and set -Operation to Delete. Pase las etiquetas que quiere eliminar.Pass in the tags you want to delete.

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

Se quitan las etiquetas especificadas.The specified tags are removed.

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

Para quitar todas las etiquetas, use el comando Remove-AzTag.To remove all tags, use the Remove-AzTag command.

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

Azure CLIAzure CLI

Aplicación de etiquetasApply tags

La CLI de Azure ofrece dos comandos para aplicar etiquetas: az tag create y az tag update.Azure CLI offers two commands for applying tags - az tag create and az tag update. Debe tener la CLI de Azure 2.10.0 o una versión posterior.You must have Azure CLI 2.10.0 or later. Puede consultar su versión con az version.You can check your version with az version. Para actualizar o instalar, consulte Instalación de CLI de Azure.To update or install, see Install the Azure CLI.

az tag create reemplaza todas las etiquetas en el recurso, el grupo de recursos o la suscripción.The az tag create replaces all tags on the resource, resource group, or subscription. Al llamar al comando, pase el id. de recurso de la entidad que desea etiquetar.When calling the command, pass in the resource ID of the entity you wish to tag.

En el ejemplo siguiente se aplica un conjunto de etiquetas a una cuenta de almacenamiento:The following example applies a set of tags to a storage account:

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.When the command completes, notice that the resource has two tags.

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

Si vuelve a ejecutar el comando, pero esta vez con etiquetas diferentes, observe que se quitaron las etiquetas anteriores.If you run the command again but this time with different tags, notice that the earlier tags are removed.

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.To add tags to a resource that already has tags, use az tag update. Establezca el parámetro --operation en Merge.Set the --operation parameter to Merge.

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

Observe que las dos etiquetas nuevas se agregaron a las dos etiquetas existentes.Notice that the two new tags were added to the two existing tags.

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

Cada nombre de etiqueta solo puede tener un valor.Each tag name can have only one value. Si proporciona un valor nuevo para una etiqueta, el valor anterior se reemplaza incluso si se usa la operación de combinación.If you provide a new value for a tag, the old value is replaced even if you use the merge operation. En el ejemplo siguiente se cambia la etiqueta Status (Estado) de Normal a Green (Verde).The following example changes the Status tag from Normal to Green.

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.When you set the --operation parameter to Replace, the existing tags are replaced by the new set of tags.

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

Solo las etiquetas nuevas siguen en el recurso.Only the new tags remain on the resource.

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

Los mismos comandos también funcionan con grupos de recursos o suscripciones.The same commands also work with resource groups or subscriptions. Puede pasar el identificador del grupo de recursos o de la suscripción que quiere etiquetar.You pass in the identifier for the resource group or subscription you want to tag.

Para agregar un nuevo conjunto de etiquetas a un grupo de recursos, use:To add a new set of tags to a resource group, 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:To update the tags for a resource group, 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:To add a new set of tags to a subscription, 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:To update the tags for a subscription, use:

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

Lista de etiquetasList tags

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.To get the tags for a resource, resource group, or subscription, use the az tag list command and pass in the resource ID for the entity.

Para ver las etiquetas de un recurso, use:To see the tags for a resource, 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:To see the tags for a resource group, 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:To see the tags for a subscription, use:

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

Enumerar por etiquetaList by tag

Para obtener recursos que tengan un nombre y valor de etiqueta específicos, use:To get resources that have a specific tag name and value, 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:To get resources that have a specific tag name with any tag value, use:

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

Para obtener grupos de recursos que tengan un nombre y valor de etiqueta específicos, use:To get resource groups that have a specific tag name and value, use:

az group list --tag Dept=Finance

Eliminación de etiquetasRemove tags

Para quitar etiquetas específicas, use az tag update y establezca --operation en Delete.To remove specific tags, use az tag update and set --operation to Delete. Pase las etiquetas que quiere eliminar.Pass in the tags you want to delete.

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

Se quitan las etiquetas especificadas.The specified tags are removed.

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

Para quitar todas las etiquetas, use el comando az tag delete.To remove all tags, use the az tag delete command.

az tag delete --resource-id $resource

Control de los espaciosHandling spaces

Si los nombres o valores de etiqueta incluyen espacios, escríbalos entre comillas dobles.If your tag names or values include spaces, enclose them in double quotes.

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

Plantillas de ARMARM templates

Puede etiquetar recursos, grupos de recursos y suscripciones durante la implementación con una plantilla de Azure Resource Manager (plantilla de ARM).You can tag resources, resource groups, and subscriptions during deployment with an Azure Resource Manager template (ARM template).

Nota

Las etiquetas que se aplican mediante la plantilla de ARM sobrescriben las existentes.The tags you apply through the ARM template overwrite any existing tags.

Aplicación de valoresApply values

En el ejemplo siguiente se implementa una cuenta de almacenamiento con tres etiquetas.The following example deploys a storage account with three tags. Dos de las etiquetas (Dept y Environment) se establecen en valores literales.Two of the tags (Dept and Environment) are set to literal values. Una etiqueta (LastDeployed) se establece en un parámetro que tiene como valor predeterminado la fecha actual.One tag (LastDeployed) is set to a parameter that defaults to the current date.

{
    "$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": [
        {
            "apiVersion": "2019-04-01",
            "type": "Microsoft.Storage/storageAccounts",
            "name": "[concat('storage', uniqueString(resourceGroup().id))]",
            "location": "[parameters('location')]",
            "tags": {
                "Dept": "Finance",
                "Environment": "Production",
                "LastDeployed": "[parameters('utcShort')]"
            },
            "sku": {
                "name": "Standard_LRS"
            },
            "kind": "Storage",
            "properties": {}
        }
    ]
}

Aplicación de un objetoApply an object

Puede definir un parámetro de objeto que almacene varias etiquetas y aplicar ese objeto al elemento de etiqueta.You can define an object parameter that stores several tags, and apply that object to the tag element. Este enfoque proporciona más flexibilidad que el ejemplo anterior, porque el objeto puede tener propiedades diferentes.This approach provides more flexibility than the previous example because the object can have different properties. Cada propiedad del objeto se convierte en una etiqueta independiente para el recurso.Each property in the object becomes a separate tag for the resource. El siguiente ejemplo tiene un parámetro denominado tagValues que se aplica al elemento de etiqueta.The following example has a parameter named tagValues that is applied to the tag element.

{
    "$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": [
        {
            "apiVersion": "2019-04-01",
            "type": "Microsoft.Storage/storageAccounts",
            "name": "[concat('storage', uniqueString(resourceGroup().id))]",
            "location": "[parameters('location')]",
            "tags": "[parameters('tagValues')]",
            "sku": {
                "name": "Standard_LRS"
            },
            "kind": "Storage",
            "properties": {}
        }
    ]
}

Aplicación de una cadena JSONApply a JSON string

Para almacenar muchos valores en una única etiqueta, aplique una cadena JSON que represente los valores.To store many values in a single tag, apply a JSON string that represents the values. Toda la cadena JSON se almacena como una etiqueta que no puede superar los 256 caracteres.The entire JSON string is stored as one tag that can't exceed 256 characters. En el ejemplo siguiente se muestra una etiqueta denominada CostCenter que contiene varios valores de una cadena JSON:The following example has a single tag named CostCenter that contains several values from a JSON string:

{
    "$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": [
        {
            "apiVersion": "2019-04-01",
            "type": "Microsoft.Storage/storageAccounts",
            "name": "[concat('storage', uniqueString(resourceGroup().id))]",
            "location": "[parameters('location')]",
            "tags": {
                "CostCenter": "{\"Dept\":\"Finance\",\"Environment\":\"Production\"}"
            },
            "sku": {
                "name": "Standard_LRS"
            },
            "kind": "Storage",
            "properties": {}
        }
    ]
}

Aplicación de etiquetas del grupo de recursosApply tags from resource group

Para aplicar etiquetas desde un grupo de recursos a un recurso, use la función resourceGroup().To apply tags from a resource group to a resource, use the resourceGroup() function. 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.When getting the tag value, use the tags[tag-name] syntax instead of the tags.tag-name syntax, because some characters aren't parsed correctly in the dot notation.

{
    "$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": [
        {
            "apiVersion": "2019-04-01",
            "type": "Microsoft.Storage/storageAccounts",
            "name": "[concat('storage', uniqueString(resourceGroup().id))]",
            "location": "[parameters('location')]",
            "tags": {
                "Dept": "[resourceGroup().tags['Dept']]",
                "Environment": "[resourceGroup().tags['Environment']]"
            },
            "sku": {
                "name": "Standard_LRS"
            },
            "kind": "Storage",
            "properties": {}
        }
    ]
}

Aplicación de etiquetas a grupos de recursos o suscripcionesApply tags to resource groups or subscriptions

Puede agregar etiquetas a un grupo de recursos o una suscripción mediante la implementación del tipo de recurso Microsoft.Resources/tags.You can add tags to a resource group or subscription by deploying the Microsoft.Resources/tags resource type. Las etiquetas se aplican al grupo de recursos o a la suscripción de destino correspondiente a la implementación.The tags are applied to the target resource group or subscription for the deployment. Cada vez que implemente la plantilla, reemplace cualquier etiqueta que haya aplicado anteriormente.Each time you deploy the template you replace any tags there were previously applied.

{
    "$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"
        }
    },
    "variables": {},
    "resources": [
        {
            "type": "Microsoft.Resources/tags",
            "name": "default",
            "apiVersion": "2019-10-01",
            "dependsOn": [],
            "properties": {
                "tags": {
                    "[parameters('tagName')]": "[parameters('tagValue')]"
                }
            }
        }
    ]
}

Para aplicar las etiquetas a un grupo de recursos, use PowerShell o la CLI de Azure.To apply the tags to a resource group, use either PowerShell or Azure CLI. Implemente en el grupo de recursos que quiere etiquetar.Deploy to the resource group that you want to tag.

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.To apply the tags to a subscription, use either PowerShell or Azure CLI. Implemente en la suscripción que quiere etiquetar.Deploy to the subscription that you want to tag.

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.For more information about subscription deployments, see Create resource groups and resources at the subscription level.

La plantilla siguiente agrega las etiquetas de un objeto a un grupo de recursos o a una suscripción.The following template adds the tags from an object to either a resource group or subscription.

"$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"
            }
        }
    },
    "variables": {},
    "resources": [
        {
            "type": "Microsoft.Resources/tags",
            "name": "default",
            "apiVersion": "2019-10-01",
            "dependsOn": [],
            "properties": {
                "tags": "[parameters('tags')]"
            }
        }
    ]
}

PortalPortal

Si un usuario no tiene el acceso necesario para aplicar etiquetas, puede asignarle el rol Colaborador de etiquetas.If a user doesn't have the required access for applying tags, you can assign the Tag Contributor role to the user. Para más información, consulte el Tutorial: Concesión de acceso de usuario a los recursos de Azure mediante RBAC y Azure Portal.For more information, see Tutorial: Grant a user access to Azure resources using RBAC and the Azure portal.

  1. Para ver las etiquetas de un recurso o un grupo de recursos, busque etiquetas existentes en la información general.To view the tags for a resource or a resource group, look for existing tags in the overview. Si no ha aplicado etiquetas anteriormente, la lista está vacía.If you have not previously applied tags, the list is empty.

    Visualización de las etiquetas por recurso o grupo de recursos

  2. Para agregar una etiqueta, seleccione Haga clic aquí para agregar etiquetas.To add a tag, select Click here to add tags.

  3. Proporcione un nombre y un valor.Provide a name and value.

    Agregar etiqueta

  4. Continúe agregando etiquetas según sea necesario.Continue adding tags as needed. Cuando haya terminado, seleccione Guardar.When done, select Save.

    Guardar etiquetas

  5. Las etiquetas aparecen ahora en la información general.The tags are now displayed in the overview.

    Mostrar etiquetas

  6. Para agregar o eliminar una etiqueta, seleccione cambiar.To add or delete a tag, select change.

  7. Para eliminar una etiqueta, seleccione el icono de papelera.To delete a tag, select the trash icon. Después, seleccione Guardar.Then, select Save.

    Eliminar etiqueta

Para asignar etiquetas a varios recursos de forma masiva:To bulk assign tags to multiple resources:

  1. En cualquier lista de recursos, seleccione la casilla de los recursos a los que quiere asignar la etiqueta.From any list of resources, select the checkbox for the resources you want to assign the tag. Después, seleccione Asignar etiquetas.Then, select Assign tags.

    Seleccionar varios recursos

  2. Agregue nombres y valores.Add names and values. Cuando haya terminado, seleccione Guardar.When done, select Save.

    Seleccionar Asignar

Para ver todos los recursos con una etiqueta:To view all resources with a tag:

  1. En el menú de Azure Portal, busque etiquetas.On the Azure portal menu, search for tags. Seleccione el servicio entre las opciones disponibles.Select it from the available options.

    Buscar por etiqueta

  2. Seleccione la etiqueta para ver los recursos.Select the tag for viewing resources.

    Seleccionar etiqueta

  3. Se muestran todos los recursos que contienen esa etiqueta.All resources with that tag are displayed.

    Visualización de recursos por etiqueta

API DE RESTREST API

Para trabajar con etiquetas a través de la API REST de Azure, use:To work with tags through the Azure REST API, use:

Herencia de etiquetasInherit tags

Los recursos no heredan las etiquetas aplicadas al grupo de recursos ni a la suscripción.Tags applied to the resource group or subscription aren't inherited by the resources. Para aplicar etiquetas de un grupo de recursos o una suscripción a los recursos, consulte Azure Policies: etiquetas.To apply tags from a subscription or resource group to the resources, see Azure Policies - tags.

Etiquetas y facturaciónTags and billing

Puede usar etiquetas a fin de agrupar los datos de facturación.You can use tags to group your billing data. Por ejemplo, si va a ejecutar varias máquinas virtuales para distintas organizaciones, use las etiquetas para agrupar el uso por centro de costo.For example, if you're running multiple VMs for different organizations, use the tags to group usage by cost center. 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.You can also use tags to categorize costs by runtime environment, such as the billing usage for VMs running in the production environment.

Puede recuperar información sobre las etiquetas si descarga el archivo de uso, un archivo de valores separados por comas (CSV) disponible en Azure Portal.You can retrieve information about tags by downloading the usage file, a comma-separated values (CSV) file available from the Azure portal. Para más información, consulte Procedimiento para descargar las datos de uso diario y de factura de Azure.For more information, see Download or view your Azure billing invoice and daily usage data. Al descargar el archivo de uso del Centro de cuentas de Azure, seleccione Versión 2.When downloading the usage file from the Azure Account Center, select Version 2. En los servicios que admiten etiquetas con facturación, las etiquetas aparecen en la columna Etiquetas.For services that support tags with billing, the tags appear in the Tags column.

Para las operaciones de API de REST, vea Referencia de API de REST de facturación de Azure.For REST API operations, see Azure Billing REST API Reference.

LimitacionesLimitations

Se aplican las siguientes limitaciones a las etiquetas:The following limitations apply to tags:

  • No todos los tipos de recursos admiten etiquetas.Not all resource types support tags. 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).To determine if you can apply a tag to a resource type, see Tag support for Azure resources.

  • Cada recurso, grupo de recursos y suscripción puede tener un máximo de 50 pares nombre-valor de etiqueta.Each resource, resource group, and subscription can have a maximum of 50 tag name/value pairs. Si necesita aplicar más etiquetas que el número máximo permitido, use una cadena JSON para el valor de etiqueta.If you need to apply more tags than the maximum allowed number, use a JSON string for the tag value. La cadena JSON puede contener muchos valores que se aplican a un sol nombre de etiqueta.The JSON string can contain many values that are applied to a single tag name. Un grupo de recursos o una suscripción puede contener muchos recursos con 50 pares clave-valor de etiqueta cada uno.A resource group or subscription can contain many resources that each have 50 tag name/value pairs.

  • El nombre de etiqueta está limitado a 512 caracteres y el valor de la etiqueta, a 256.The tag name is limited to 512 characters, and the tag value is limited to 256 characters. En las cuentas de almacenamiento, el nombre de etiqueta se limita a 128 caracteres y el valor de la etiqueta, a 256.For storage accounts, the tag name is limited to 128 characters, and the tag value is limited to 256 characters.

  • No se pueden aplicar etiquetas a recursos clásicos como Cloud Services.Tags can't be applied to classic resources such as Cloud Services.

  • Los nombres de etiqueta no pueden contener estos caracteres: <, >, %, &, \, ?, /Tag names can't contain these characters: <, >, %, &, \, ?, /

    Nota

    Actualmente, las zonas de Azure DNS y los servicios de Traffic Manager tampoco permiten el uso de espacios en la etiqueta.Currently, Azure DNS zones and Traffic Manager services also don't allow the use of spaces in the tag.

    Azure Front Door no admite el uso de # en el nombre de la etiqueta.Azure Front Door doesn't support the use of # in the tag name.

    Azure Automation y Azure CDN solo admiten 15 etiquetas en los recursos.Azure Automation and Azure CDN only support 15 tags on resources.

Pasos siguientesNext steps