Use etiquetas para organizar os seus recursos Azure e hierarquia de gestãoUse tags to organize your Azure resources and management hierarchy

Aplica etiquetas nos seus recursos Azure, grupos de recursos e subscrições para organizá-las logicamente numa taxonomia.You apply tags to your Azure resources, resource groups, and subscriptions to logically organize them into a taxonomy. Cada etiqueta é composta por um nome e um par de valor.Each tag consists of a name and a value pair. Por exemplo, pode aplicar o nome "Ambiente" e o valor "Produção" em todos os recursos na produção.For example, you can apply the name "Environment" and the value "Production" to all the resources in production.

Para obter recomendações sobre como implementar uma estratégia de marcação, consulte o guia de decisão de nomeação de recursos e marcação.For recommendations on how to implement a tagging strategy, see Resource naming and tagging decision guide.

Importante

Os nomes das etiquetas são insensíveis para operações.Tag names are case-insensitive for operations. Uma etiqueta com um nome de etiqueta, independentemente do invólucro, é atualizada ou recuperada.A tag with a tag name, regardless of casing, is updated or retrieved. No entanto, o fornecedor de recursos pode manter o invólucro que fornece para o nome da etiqueta.However, the resource provider might keep the casing you provide for the tag name. Verá o invólucro nos relatórios de custos.You'll see that casing in cost reports.

Os valores da etiqueta são sensíveis a maiôs.Tag values are case-sensitive.

Nota

Este artigo mostra os passos para eliminar dados pessoais do dispositivo ou serviço e pode ser utilizado para dar apoio às suas obrigações ao abrigo do GDPR.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. Se estiver à procura de informações gerais sobre o GDPR, veja a secção GDPR do Portal de Confiança do Serviço.If you’re looking for general info about GDPR, see the GDPR section of the Service Trust portal.

Acesso obrigatórioRequired access

Para aplicar tags a um recurso, tem de ter acesso de escrita ao tipo de recurso Microsoft.Resources/tags.To apply tags to a resource, you must have write access to the Microsoft.Resources/tags resource type. A função Tag Contributor permite aplicar tags a uma entidade sem ter acesso à própria entidade.The Tag Contributor role lets you apply tags to an entity without having access to the entity itself. Atualmente, o papel de contribuinte de etiquetas não pode aplicar tags a recursos ou grupos de recursos através do portal.Currently, the tag contributor role can't apply tags to resources or resource groups through the portal. Pode aplicar tags a subscrições através do portal.It can apply tags to subscriptions through the portal. Suporta todas as operações de tag através da PowerShell e da REST API.It supports all tag operations through PowerShell and REST API.

A função Contribuinte também concede o acesso necessário à aplicação de etiquetas a qualquer entidade.The Contributor role also grants the required access to apply tags to any entity. Para aplicar etiquetas a apenas um tipo de recurso, utilize a função de contribuinte para esse recurso.To apply tags to only one resource type, use the contributor role for that resource. Por exemplo, para aplicar tags em máquinas virtuais, utilize o Contribuinte Máquina Virtual.For example, to apply tags to virtual machines, use the Virtual Machine Contributor.

PowerShellPowerShell

Aplicar tagsApply tags

A Azure PowerShell oferece dois comandos para a aplicação de tags - New-AzTag e Update-AzTag.Azure PowerShell offers two commands for applying tags - New-AzTag and Update-AzTag. Deve ter o módulo Az.Resources 1.12.0 ou mais tarde.You must have the Az.Resources module 1.12.0 or later. Pode verificar a sua versão com Get-Module Az.Resources .You can check your version with Get-Module Az.Resources. Pode instalar esse módulo ou instalar o Azure PowerShell 3.6.1 ou mais tarde.You can install that module or install Azure PowerShell 3.6.1 or later.

O New-AzTag substitui todas as tags no recurso, grupo de recursos ou subscrição.The New-AzTag replaces all tags on the resource, resource group, or subscription. Ao ligar para o comando, passe na identificação de recursos da entidade que deseja marcar.When calling the command, pass in the resource ID of the entity you wish to tag.

O exemplo a seguir aplica um conjunto de etiquetas a uma conta de armazenamento: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

Quando o comando estiver concluído, note que o recurso tem duas etiquetas.When the command completes, notice that the resource has two tags.

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

Se voltar a executar o comando, mas desta vez com etiquetas diferentes, note que as etiquetas anteriores são removidas.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 adicionar tags a um recurso que já tem tags, utilize Update-AzTag.To add tags to a resource that already has tags, use Update-AzTag. Desa estação o parâmetro de operação para a fusão.Set the -Operation parameter to Merge.

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

Note que as duas novas etiquetas foram adicionadas às duas 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 nome de etiqueta pode ter apenas um valor.Each tag name can have only one value. Se fornecer um novo valor para uma etiqueta, o valor antigo é substituído mesmo que utilize a operação de fusão.If you provide a new value for a tag, the old value is replaced even if you use the merge operation. O exemplo a seguir altera a etiqueta de Estado de Normal para 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

Quando definir o parâmetro de operação para substituir, as etiquetas existentes são substituídas pelo novo conjunto de etiquetas.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

Apenas as novas etiquetas permanecem no recurso.Only the new tags remain on the resource.

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

Os mesmos comandos também funcionam com grupos de recursos ou subscrições.The same commands also work with resource groups or subscriptions. Você passa no identificador para o grupo de recursos ou subscrição que deseja marcar.You pass in the identifier for the resource group or subscription you want to tag.

Para adicionar um novo conjunto de tags a um grupo de recursos, utilize: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 atualizar as etiquetas para um grupo de recursos, utilize: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 adicionar um novo conjunto de tags a uma subscrição, utilize: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 atualizar as etiquetas para uma subscrição, utilize: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

Pode ter mais do que um recurso com o mesmo nome num grupo de recursos.You may have more than one resource with the same name in a resource group. Nesse caso, pode definir cada recurso com os seguintes 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 }

Listar etiquetasList tags

Para obter as etiquetas para um recurso, grupo de recursos ou subscrição, utilize o comando Get-AzTag e passe no ID de recursos para a entidade.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 as etiquetas para um recurso, use:To see the tags for a resource, use:

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

Para ver as etiquetas de um grupo de recursos, utilize:To see the tags for a resource group, use:

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

Para ver as etiquetas para uma subscrição, utilize:To see the tags for a subscription, use:

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

Lista por etiquetaList by tag

Para obter recursos que tenham um nome e valor específicos, use:To get resources that have a specific tag name and value, use:

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

Para obter recursos que tenham um nome de identificação específico com qualquer valor de etiqueta, use:To get resources that have a specific tag name with any tag value, use:

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

Para obter grupos de recursos que tenham um nome e valor específicos, utilize:To get resource groups that have a specific tag name and value, use:

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

Remover tagsRemove tags

Para remover etiquetas específicas, utilize Update-AzTag e desemote -Operação para Eliminar.To remove specific tags, use Update-AzTag and set -Operation to Delete. Passe as etiquetas que pretende apagar.Pass in the tags you want to delete.

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

As etiquetas especificadas são removidas.The specified tags are removed.

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

Para remover todas as etiquetas, utilize o comando Remove-AzTag.To remove all tags, use the Remove-AzTag command.

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

CLI do AzureAzure CLI

Aplicar tagsApply tags

Ao adicionar tags a um grupo de recursos ou a um recurso, pode substituir as etiquetas existentes ou anexar novas etiquetas às etiquetas existentes.When adding tags to a resource group or resource, you can either overwrite the existing tags or append new tags to existing tags.

Para substituir as etiquetas num recurso, utilize:To overwrite the tags on a resource, use:

az resource tag --tags 'Dept=IT' 'Environment=Test' -g examplegroup -n examplevnet --resource-type "Microsoft.Network/virtualNetworks"

Para anexar uma etiqueta às etiquetas existentes num recurso, utilize:To append a tag to the existing tags on a resource, use:

az resource update --set tags.'Status'='Approved' -g examplegroup -n examplevnet --resource-type "Microsoft.Network/virtualNetworks"

Para substituir as etiquetas existentes num grupo de recursos, utilize:To overwrite the existing tags on a resource group, use:

az group update -n examplegroup --tags 'Environment=Test' 'Dept=IT'

Para anexar uma etiqueta às etiquetas existentes num grupo de recursos, utilize:To append a tag to the existing tags on a resource group, use:

az group update -n examplegroup --set tags.'Status'='Approved'

Atualmente, o Azure CLI não tem um comando para aplicar tags a subscrições.Currently, Azure CLI doesn't have a command for applying tags to subscriptions. No entanto, pode utilizar o CLI para implementar um modelo ARM que aplica as tags a uma subscrição.However, you can use CLI to deploy an ARM template that applies the tags to a subscription. Consulte as etiquetas aplicadas a grupos de recursos ou subscrições.See Apply tags to resource groups or subscriptions.

Listar etiquetasList tags

Para ver as etiquetas existentes para um recurso, utilize:To see the existing tags for a resource, use:

az resource show -n examplevnet -g examplegroup --resource-type "Microsoft.Network/virtualNetworks" --query tags

Para ver as etiquetas existentes de um grupo de recursos, utilize:To see the existing tags for a resource group, use:

az group show -n examplegroup --query tags

Este script devolve o formato seguinte:That script returns the following format:

{
  "Dept"        : "IT",
  "Environment" : "Test"
}

Lista por etiquetaList by tag

Para obter todos os recursos que têm uma etiqueta e valor particulares, az resource list use:To get all the resources that have a particular tag and value, use az resource list:

az resource list --tag Dept=Finance

Para obter grupos de recursos que tenham uma etiqueta específica, az group list use:To get resource groups that have a specific tag, use az group list:

az group list --tag Dept=IT

Espaços de manuseamentoHandling spaces

Se os seus nomes ou valores incluem espaços, deve dar alguns passos extras.If your tag names or values include spaces, you must take a couple extra steps.

Os --tags parâmetros no CLI Azure podem aceitar uma corda que consiste numa matriz de cordas.The --tags parameters in the Azure CLI can accept a string that consists of an array of strings. O exemplo a seguir substitui as etiquetas num grupo de recursos onde as etiquetas têm espaços e hífen:The following example overwrites the tags in a resource group where the tags have spaces and hyphen:

TAGS=("Cost Center=Finance-1222" "Location=West US")
az group update --name examplegroup --tags "${TAGS[@]}"

Pode utilizar a mesma sintaxe quando criar ou atualizar um grupo de recursos ou recursos utilizando o --tags parâmetro.You can use the same syntax when you create or update a resource group or resources by using the --tags parameter.

Para atualizar as etiquetas utilizando o --set parâmetro, tem de passar a chave e o valor como uma cadeia.To update the tags by using the --set parameter, you must pass the key and value as a string. O exemplo a seguir anexa uma única etiqueta a um grupo de recursos:The following example appends a single tag to a resource group:

TAG="Cost Center='Account-56'"
az group update --name examplegroup --set tags."$TAG"

Neste caso, o valor da etiqueta é marcado com cotações únicas porque o valor tem um hífen.In the this case, the tag value is marked with single quotes because the value has a hyphen.

Também pode precisar de aplicar etiquetas a muitos recursos.You might also need to apply tags to many resources. O exemplo a seguir aplica todas as tags de um grupo de recursos aos seus recursos quando as tags podem conter espaços:The following example applies all tags from a resource group to its resources when the tags might contain spaces:

jsontags=$(az group show --name examplegroup --query tags -o json)
tags=$(echo $jsontags | tr -d '{}"' | sed 's/: /=/g' | sed "s/\"/'/g" | sed 's/, /,/g' | sed 's/ *$//g' | sed 's/^ *//g')
origIFS=$IFS
IFS=','
read -a tagarr <<< "$tags"
resourceids=$(az resource list -g examplegroup --query [].id --output tsv)
for id in $resourceids
do
  az resource tag --tags "${tagarr[@]}" --id $id
done
IFS=$origIFS

ModelosTemplates

Pode marcar recursos, grupos de recursos e subscrições durante a implementação com um modelo de Gestor de Recursos.You can tag resources, resource groups, and subscriptions during deployment with a Resource Manager template.

Aplicar valoresApply values

O exemplo a seguir implanta uma conta de armazenamento com três etiquetas.The following example deploys a storage account with three tags. Duas das etiquetas Dept Environment (e) são definidas para valores literais.Two of the tags (Dept and Environment) are set to literal values. Uma etiqueta LastDeployed () é definida como um parâmetro que predefini a data atual.One tag (LastDeployed) is set to a parameter that defaults to the current date.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-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": {}
        }
    ]
}

Aplicar um objetoApply an object

Pode definir um parâmetro de objeto que armazene várias etiquetas e aplicar esse objeto no elemento da etiqueta.You can define an object parameter that stores several tags, and apply that object to the tag element. Esta abordagem proporciona mais flexibilidade do que o exemplo anterior porque o objeto pode ter propriedades diferentes.This approach provides more flexibility than the previous example because the object can have different properties. Cada propriedade no objeto torna-se uma etiqueta separada para o recurso.Each property in the object becomes a separate tag for the resource. O exemplo seguinte tem um parâmetro denominado tagValues que é aplicado no elemento da etiqueta.The following example has a parameter named tagValues that is applied to the tag element.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-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": {}
        }
    ]
}

Aplique uma corda JSONApply a JSON string

Para armazenar muitos valores numa única etiqueta, aplique uma cadeia JSON que represente os valores.To store many values in a single tag, apply a JSON string that represents the values. Toda a cadeia JSON é armazenada como uma etiqueta que não pode exceder 256 caracteres.The entire JSON string is stored as one tag that can't exceed 256 characters. O exemplo seguinte tem uma única etiqueta com o nome CostCenter que contém vários valores de uma cadeia 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/2015-01-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": {}
        }
    ]
}

Aplicar tags do grupo de recursosApply tags from resource group

Para aplicar tags de um grupo de recursos a um recurso, utilize a função Grupo de Recursos()To apply tags from a resource group to a resource, use the resourceGroup() function. Ao obter o valor da etiqueta, use a tags[tag-name] sintaxe em vez da tags.tag-name sintaxe, porque alguns caracteres não são analisados corretamente na notação do ponto.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/2015-01-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": {}
        }
    ]
}

Aplicar tags em grupos de recursos ou subscriçõesApply tags to resource groups or subscriptions

Pode adicionar tags a um grupo de recursos ou subscrição através da implementação do tipo de recurso Microsoft.Resources/tags.You can add tags to a resource group or subscription by deploying the Microsoft.Resources/tags resource type. As etiquetas são aplicadas ao grupo de recursos-alvo ou subscrição para a implementação.The tags are applied to the target resource group or subscription for the deployment. Cada vez que implementar o modelo substitui quaisquer tags, foram previamente aplicadas.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 as etiquetas num grupo de recursos, utilize o PowerShell ou o Azure CLI.To apply the tags to a resource group, use either PowerShell or Azure CLI. Implemente para o grupo de recursos que pretende marcar.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 as etiquetas numa subscrição, utilize o PowerShell ou o Azure CLI.To apply the tags to a subscription, use either PowerShell or Azure CLI. Implemente a subscrição que pretende marcar.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 obter mais informações sobre as implementações de subscrição, consulte Criar grupos de recursos e recursos ao nível da subscrição.For more information about subscription deployments, see Create resource groups and resources at the subscription level.

O modelo a seguir adiciona as tags de um objeto a um grupo de recursos ou a uma subscrição.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

Se um utilizador não tiver o acesso necessário para aplicar tags, pode atribuir a função De Colaborador tag ao utilizador.If a user doesn't have the required access for applying tags, you can assign the Tag Contributor role to the user. Para obter mais informações, consulte Tutorial: Conceder a um utilizador acesso aos recursos do Azure utilizando o RBAC e o portal Azure.For more information, see Tutorial: Grant a user access to Azure resources using RBAC and the Azure portal.

  1. Para visualizar as etiquetas para um recurso ou um grupo de recursos, procure etiquetas existentes na visão geral.To view the tags for a resource or a resource group, look for existing tags in the overview. Se não tiver aplicado etiquetas anteriormente, a lista estará vazia.If you have not previously applied tags, the list is empty.

    Ver tags para recursos ou grupo de recursos

  2. Para adicionar uma etiqueta, selecione Clique aqui para adicionar tags.To add a tag, select Click here to add tags.

  3. Forneça um nome e valor.Provide a name and value.

    Adicionar etiqueta

  4. Continue a adicionar etiquetas conforme necessário.Continue adding tags as needed. Quando terminar, selecione Guardar.When done, select Save.

    Guardar tags

  5. As etiquetas são agora apresentadas no panorama geral.The tags are now displayed in the overview.

    Mostrar tags

  6. Para adicionar ou eliminar uma etiqueta, selecione alterar.To add or delete a tag, select change.

  7. Para eliminar uma etiqueta, selecione o ícone do lixo.To delete a tag, select the trash icon. Em seguida, selecione Save.Then, select Save.

    Eliminar tag

Para atribuir etiquetas a granel a múltiplos recursos:To bulk assign tags to multiple resources:

  1. A partir de qualquer lista de recursos, selecione a caixa de verificação para os recursos que pretende atribuir à etiqueta.From any list of resources, select the checkbox for the resources you want to assign the tag. Em seguida, selecione Atribuir tags.Then, select Assign tags.

    Selecione vários recursos

  2. Adicione nomes e valores.Add names and values. Quando terminar, selecione Guardar.When done, select Save.

    Selecione atribuir

Para ver todos os recursos com uma etiqueta:To view all resources with a tag:

  1. No menu do portal Azure, procure etiquetas.On the Azure portal menu, search for tags. Selecione-o nas opções disponíveis.Select it from the available options.

    Encontrar por etiqueta

  2. Selecione a etiqueta para visualizar recursos.Select the tag for viewing resources.

    Selecione tag

  3. Todos os recursos com esta etiqueta são exibidos.All resources with that tag are displayed.

    Ver recursos por etiqueta

API RESTREST API

Para trabalhar com tags através da AZure REST API, utilize:To work with tags through the Azure REST API, use:

Herdar etiquetasInherit tags

As etiquetas aplicadas ao grupo de recursos ou subscrição não são herdadas pelos recursos.Tags applied to the resource group or subscription aren't inherited by the resources. Para aplicar tags de um grupo de subscrição ou de recursos aos recursos, consulte Azure Policies - tags.To apply tags from a subscription or resource group to the resources, see Azure Policies - tags.

Etiquetas e faturaçãoTags and billing

Pode utilizar etiquetas para agrupar os seus dados de faturação.You can use tags to group your billing data. Por exemplo, se estiver a executar múltiplas VMs para organizações diferentes, utilize as etiquetas para agrupar a utilização por centro de custos.For example, if you're running multiple VMs for different organizations, use the tags to group usage by cost center. Também pode utilizar etiquetas para categorizar os custos por ambiente de runtime, tal como a utilização de faturação das VMs executadas no ambiente de produção.You can also use tags to categorize costs by runtime environment, such as the billing usage for VMs running in the production environment.

Pode obter informações sobre tags através das APIs de Utilização de Recursos Azure e tarifas ou do ficheiro valores separados por vírgulas de utilização (CSV).You can retrieve information about tags through the Azure Resource Usage and Rate Card APIs or the usage comma-separated values (CSV) file. Descarregue o ficheiro de utilização do portal Azure.You download the usage file from the Azure portal. Para mais informações, consulte Download ou consulte a sua faturação Azure e dados de utilização diários.For more information, see Download or view your Azure billing invoice and daily usage data. Ao descarregar o ficheiro de utilização do Centro de Conta Azure, selecione a Versão 2.When downloading the usage file from the Azure Account Center, select Version 2. Para serviços que suportam etiquetas com faturação, as etiquetas aparecem na coluna Tags.For services that support tags with billing, the tags appear in the Tags column.

Para operações rest API, consulte referência API API de Faturação AZure.For REST API operations, see Azure Billing REST API Reference.

LimitaçõesLimitations

As seguintes limitações aplicam-se às etiquetas:The following limitations apply to tags:

  • Nem todos os tipos de recursos suportam tags.Not all resource types support tags. Para determinar se pode aplicar uma etiqueta a um tipo de recurso, consulte o suporte da Tag para os recursos do Azure.To determine if you can apply a tag to a resource type, see Tag support for Azure resources.

  • Cada recurso, grupo de recursos e subscrição podem ter um máximo de 50 pares de nome/valor de etiqueta.Each resource, resource group, and subscription can have a maximum of 50 tag name/value pairs. Se precisar de aplicar mais etiquetas do que o número máximo permitido, utilize uma corda JSON para o valor da etiqueta.If you need to apply more tags than the maximum allowed number, use a JSON string for the tag value. A cadeia JSON pode conter muitos valores que são aplicados a um nome de etiqueta individual.The JSON string can contain many values that are applied to a single tag name. Um grupo de recursos ou subscrição pode conter muitos recursos que cada um tem 50 pares de nome/valor de tag.A resource group or subscription can contain many resources that each have 50 tag name/value pairs.

  • O nome de etiqueta está limitado a 512 caracteres e o valor a 256.The tag name is limited to 512 characters, and the tag value is limited to 256 characters. Nas contas de armazenamento, o nome da etiqueta está limitado a 128 caracteres e o valor a 256.For storage accounts, the tag name is limited to 128 characters, and the tag value is limited to 256 characters.

  • As etiquetas não podem ser aplicadas a recursos clássicos como os Cloud Services.Tags can't be applied to classic resources such as Cloud Services.

  • Os nomes das etiquetas não podem conter estes caracteres: < , , , , > % & \ ? , /Tag names can't contain these characters: <, >, %, &, \, ?, /

    Nota

    Atualmente, as zonas de DNS do Azure e os serviços de Gerente de Tráfego também não permitem a utilização de espaços na etiqueta.Currently, Azure DNS zones and Traffic Manager services also don't allow the use of spaces in the tag.

    AZure Front Door não suporta o uso # do nome da etiqueta.Azure Front Door doesn't support the use of # in the tag name.

    A Azure Automation e a Azure CDN suportam apenas 15 tags em recursos.Azure Automation and Azure CDN only support 15 tags on resources.

Passos seguintesNext steps