Use marcas para organizar os recursos e a hierarquia de gerenciamento do AzureUse tags to organize your Azure resources and management hierarchy

Você aplica marcas aos recursos, grupos de recursos e assinaturas do Azure para organizá-los logicamente em uma taxonomia.You apply tags to your Azure resources, resource groups, and subscriptions to logically organize them into a taxonomy. Cada marca consiste em um par de nome/valor.Each tag consists of a name and a value pair. Por exemplo, você pode aplicar o nome "Ambiente" e o valor "Produção" a 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 nomenclatura de recursos e guia de decisão de marcação.For recommendations on how to implement a tagging strategy, see Resource naming and tagging decision guide.

Importante

Os nomes de marca não diferenciam maiúsculas de minúsculas para operações.Tag names are case-insensitive for operations. Uma marca com um nome de marca, independentemente de maiúsculas e minúsculas, é atualizada ou recuperada.A tag with a tag name, regardless of casing, is updated or retrieved. No entanto, o provedor de recursos pode manter a capitalização que você fornece para o nome da marca.However, the resource provider might keep the casing you provide for the tag name. Você verá essa capitalização nos relatórios de custo.You'll see that casing in cost reports.

Os valores de marca diferenciam maiúsculas de minúsculas.Tag values are case-sensitive.

Observação

Este artigo mostra as etapas de como excluir dados pessoais do dispositivo ou serviço e pode ser usado para dar suporte às suas obrigações de acordo com o 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 você estiver buscando informações gerais sobre o GDPR, confira a seção GDPR do portal do serviço de confiança.If you’re looking for general info about GDPR, see the GDPR section of the Service Trust portal.

Acesso necessárioRequired access

Há duas maneiras de obter o acesso necessário aos recursos de marca.There are two ways to get the required access to tag resources.

  • Você pode ter acesso de gravação ao tipo de recurso Microsoft. Resources/Tags .You can have write access to the Microsoft.Resources/tags resource type. Esse acesso permite marcar qualquer recurso, mesmo que você não tenha acesso ao próprio recurso.This access lets you tag any resource, even if you don't have access to the resource itself. A função de colaborador de marca concede esse acesso.The Tag Contributor role grants this access. Atualmente, a função de colaborador de marca não pode aplicar marcas a recursos ou grupos de recursos por meio do Portal.Currently, the tag contributor role can't apply tags to resources or resource groups through the portal. Ele pode aplicar marcas às assinaturas por meio do Portal.It can apply tags to subscriptions through the portal. Ele dá suporte a todas as operações de marca por meio do PowerShell e da API REST.It supports all tag operations through PowerShell and REST API.

  • Você pode ter acesso de gravação ao próprio recurso.You can have write access to the resource itself. A função colaborador concede o acesso necessário para aplicar marcas a qualquer entidade.The Contributor role grants the required access to apply tags to any entity. Para aplicar marcas a apenas um tipo de recurso, use a função de colaborador para esse recurso.To apply tags to only one resource type, use the contributor role for that resource. Por exemplo, para aplicar marcas a máquinas virtuais, use o Colaborador da Máquina Virtual.For example, to apply tags to virtual machines, use the Virtual Machine Contributor.

PowerShellPowerShell

Aplicar marcasApply tags

O Azure PowerShell oferece dois comandos para aplicar marcas- New-AzTag e Update-AzTag.Azure PowerShell offers two commands for applying tags - New-AzTag and Update-AzTag. Você deve ter o módulo AZ. Resources 1.12.0 ou posterior.You must have the Az.Resources module 1.12.0 or later. Você pode verificar sua versão com Get-Module Az.Resources .You can check your version with Get-Module Az.Resources. Você pode instalar esse módulo ou instalar o Azure PowerShell 3.6.1 ou posterior.You can install that module or install Azure PowerShell 3.6.1 or later.

O New-AzTag substitui todas as marcas no recurso, no grupo de recursos ou na assinatura.The New-AzTag replaces all tags on the resource, resource group, or subscription. Ao chamar o comando, passe a ID de recurso da entidade que você 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 marcas 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 for concluído, observe que o recurso tem duas marcas.When the command completes, notice that the resource has two tags.

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

Se você executar o comando novamente, mas desta vez com marcas diferentes, observe que as marcas 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 marcas a um recurso que já tem marcas, use Update-AzTag.To add tags to a resource that already has tags, use Update-AzTag. Defina o parâmetro -Operation para mesclar.Set the -Operation parameter to Merge.

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

Observe que as duas novas marcas foram adicionadas às duas marcas 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 marca pode ter apenas um valor.Each tag name can have only one value. Se você fornecer um novo valor para uma marca, o valor antigo será substituído mesmo se você usar a operação de mesclagem.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 marca de status 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 você define o parâmetro -Operation como replace, as marcas existentes são substituídas pelo novo conjunto de marcas.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

Somente as novas marcas 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 assinaturas.The same commands also work with resource groups or subscriptions. Você passa o identificador do grupo de recursos ou da assinatura que deseja marcar.You pass in the identifier for the resource group or subscription you want to tag.

Para adicionar um novo conjunto de marcas a um 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 atualizar as marcas de um 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 adicionar um novo conjunto de marcas a uma assinatura, 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 atualizar as marcas de uma assinatura, 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

Você pode ter mais de um recurso com o mesmo nome em um grupo de recursos.You may have more than one resource with the same name in a resource group. Nesse caso, você 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 marcasList tags

Para obter as marcas de um recurso, grupo de recursos ou assinatura, use o comando Get-AzTag e passe a ID do recurso 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 marcas de 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 marcas de um 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 as marcas de uma assinatura, use:To see the tags for a subscription, use:

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

Listar por marcaList by tag

Para obter recursos que têm um nome e valor de marca 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 têm um nome de marca específico com qualquer valor de marca, use:To get resources that have a specific tag name with any tag value, use:

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

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

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

Remover marcasRemove tags

Para remover marcas específicas, use Update-AzTag e Set -Operation para excluir.To remove specific tags, use Update-AzTag and set -Operation to Delete. Passe as marcas que você deseja excluir.Pass in the tags you want to delete.

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

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

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

Para remover todas as marcas, use 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 marcasApply tags

CLI do Azure oferece dois comandos para aplicar marcas- AZ tag Create e AZ tag update.Azure CLI offers two commands for applying tags - az tag create and az tag update. Você deve ter CLI do Azure 2.10.0 ou posterior.You must have Azure CLI 2.10.0 or later. Você pode verificar sua versão com az version .You can check your version with az version. Para atualizar ou instalar o, consulte instalar o CLI do Azure.To update or install, see Install the Azure CLI.

A tag AZ Create substitui todas as marcas no recurso, no grupo de recursos ou na assinatura.The az tag create replaces all tags on the resource, resource group, or subscription. Ao chamar o comando, passe a ID de recurso da entidade que você 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 marcas a uma conta de armazenamento: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

Quando o comando for concluído, observe que o recurso tem duas marcas.When the command completes, notice that the resource has two tags.

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

Se você executar o comando novamente, mas desta vez com marcas diferentes, observe que as marcas anteriores são removidas.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 adicionar marcas a um recurso que já tem marcas, use az tag update .To add tags to a resource that already has tags, use az tag update. Defina o parâmetro de --operation a Merge.Set the --operation parameter to Merge.

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

Observe que as duas novas marcas foram adicionadas às duas marcas 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 nome de marca pode ter apenas um valor.Each tag name can have only one value. Se você fornecer um novo valor para uma marca, o valor antigo será substituído mesmo se você usar a operação de mesclagem.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 marca de status de normal para 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"
  }
},

Quando você define o --operation parâmetro como Replace , as marcas existentes são substituídas pelo novo conjunto de marcas.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

Somente as novas marcas permanecem no recurso.Only the new tags remain on the resource.

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

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

Para adicionar um novo conjunto de marcas a um 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 atualizar as marcas de um 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 adicionar um novo conjunto de marcas a uma assinatura, 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 atualizar as marcas de uma assinatura, use:To update the tags for a subscription, use:

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

Listar marcasList tags

Para obter as marcas de um recurso, grupo de recursos ou assinatura, use o comando AZ tag List e passe a ID do recurso para a entidade.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 as marcas de um 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 as marcas de um 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 as marcas de uma assinatura, 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

Listar por marcaList by tag

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

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

Para obter recursos que têm um nome de marca específico com qualquer valor de marca, use:To get resources that have a specific tag name with any tag value, use:

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

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

az group list --tag Dept=Finance

Remover marcasRemove tags

Para remover marcas específicas, use az tag update e defina --operation como Delete .To remove specific tags, use az tag update and set --operation to Delete. Passe as marcas que você deseja excluir.Pass in the tags you want to delete.

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

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

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

Para remover todas as marcas, use o comando AZ tag Delete .To remove all tags, use the az tag delete command.

az tag delete --resource-id $resource

Espaços de manuseioHandling spaces

Se os nomes ou valores de marcação incluírem espaços, coloque-os entre aspas duplas.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"

Modelos de ARMARM templates

Você pode marcar recursos, grupos de recursos e assinaturas durante a implantação com um modelo de Azure Resource Manager (modelo ARM).You can tag resources, resource groups, and subscriptions during deployment with an Azure Resource Manager template (ARM template).

Observação

As marcas aplicadas por meio do modelo ARM substituem todas as marcas existentes.The tags you apply through the ARM template overwrite any existing tags.

Aplicar valoresApply values

O exemplo a seguir implanta uma conta de armazenamento com três marcas.The following example deploys a storage account with three tags. Duas das marcas ( Dept e Environment ) são definidas como valores literais.Two of the tags (Dept and Environment) are set to literal values. Uma marca ( LastDeployed ) é definida como um parâmetro que usa como padrão a data atual.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": {}
        }
    ]
}

Aplicar um objetoApply an object

Você pode definir um parâmetro de objeto que armazena várias marcas e aplicar esse objeto para o elemento de marca.You can define an object parameter that stores several tags, and apply that object to the tag element. Essa abordagem fornece 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 se torna uma marca separada para o recurso.Each property in the object becomes a separate tag for the resource. O exemplo a seguir tem um parâmetro chamado tagValues que é aplicado ao elemento de marca.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": {}
        }
    ]
}

Aplicar uma cadeia de caracteres JSONApply a JSON string

Para armazenar diversos valores em uma única marca, aplica uma cadeia de caracteres JSON que representa os valores.To store many values in a single tag, apply a JSON string that represents the values. A cadeia de caracteres JSON inteira é armazenada como uma marca que não pode exceder 256 caracteres.The entire JSON string is stored as one tag that can't exceed 256 characters. O exemplo a seguir tem uma única marca denominada CostCenter que contém vários valores de uma cadeia de caracteres 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": {}
        }
    ]
}

Aplicar marcas do grupo de recursosApply tags from resource group

Para aplicar marcas de um grupo de recursos a um recurso, use a função resourcegroup () .To apply tags from a resource group to a resource, use the resourceGroup() function. Ao obter o valor da marca, 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 de 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/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": {}
        }
    ]
}

Aplicar marcas a grupos de recursos ou assinaturasApply tags to resource groups or subscriptions

Você pode adicionar marcas a um grupo de recursos ou assinatura implantando o 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 marcas são aplicadas ao grupo de recursos de destino ou à assinatura para a implantação.The tags are applied to the target resource group or subscription for the deployment. Cada vez que você implanta o modelo, você substitui todas as marcas que foram aplicadas 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 as marcas a um grupo de recursos, use o PowerShell ou CLI do Azure.To apply the tags to a resource group, use either PowerShell or Azure CLI. Implante no grupo de recursos que você deseja 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 marcas a uma assinatura, use o PowerShell ou CLI do Azure.To apply the tags to a subscription, use either PowerShell or Azure CLI. Implante na assinatura que você deseja 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 implantações de assinatura, consulte criar grupos de recursos e recursos no nível da assinatura.For more information about subscription deployments, see Create resource groups and resources at the subscription level.

O modelo a seguir adiciona as marcas de um objeto a um grupo de recursos ou assinatura.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 usuário não tiver o acesso necessário para aplicar marcas, você poderá atribuir a função Colaborador de Marca a ele.If a user doesn't have the required access for applying tags, you can assign the Tag Contributor role to the user. Para saber mais, confira Tutorial: Conceder acesso aos recursos do Azure para um usuário usando o RBAC e o portal do Azure.For more information, see Tutorial: Grant a user access to Azure resources using RBAC and the Azure portal.

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

    Visualizar marcas para recurso ou grupo de recursos

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

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

    Adicionar marca

  4. Continue adicionando marcas conforme necessário.Continue adding tags as needed. Ao terminar, escolha Salvar.When done, select Save.

    Salvar marcas

  5. As marcas são exibidas agora na visão geral.The tags are now displayed in the overview.

    Mostrar marcas

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

  7. Para excluir uma marca, selecione o ícone de lixeira.To delete a tag, select the trash icon. Em seguida, selecione Salvar.Then, select Save.

    Excluir marca

Para atribuir marcas em massa para vários recursos:To bulk assign tags to multiple resources:

  1. A partir de qualquer lista de recursos, selecione a caixa de seleção para os recursos aos quais você deseja atribuir a marca.From any list of resources, select the checkbox for the resources you want to assign the tag. Em seguida, selecione Atribuir marcas.Then, select Assign tags.

    Selecionar vários recursos

  2. Adicionar valores e nomes.Add names and values. Ao terminar, escolha Salvar.When done, select Save.

    Selecione atribuir

Para exibir todos os recursos com uma marca:To view all resources with a tag:

  1. No menu do portal do Azure, pesquise marcas.On the Azure portal menu, search for tags. Selecione-as entre as opções disponíveis.Select it from the available options.

    Localizar por marca

  2. Selecione a marca para recursos de visualização.Select the tag for viewing resources.

    Selecionar marca

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

    Visualizar recursos por marca

API RESTREST API

Para trabalhar com marcas por meio da API REST do Azure, use:To work with tags through the Azure REST API, use:

Herdar marcasInherit tags

As marcas aplicadas ao grupo de recursos ou à assinatura não são herdadas pelos recursos.Tags applied to the resource group or subscription aren't inherited by the resources. Para aplicar marcas de uma assinatura ou grupo de recursos aos recursos, consulte políticas do Azure – marcas.To apply tags from a subscription or resource group to the resources, see Azure Policies - tags.

Marcas e cobrançaTags and billing

Você pode usar marcas para agrupar os dados de cobrança.You can use tags to group your billing data. Por exemplo, se estiver executando várias VMs para organizações diferentes, use as marcas para agrupar o uso por centro de custo.For example, if you're running multiple VMs for different organizations, use the tags to group usage by cost center. Você também pode usar marcas para categorizar os custos pelo ambiente de runtime, como por exemplo, o uso de cobrança para VMs em execução 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.

Você pode recuperar informações sobre marcas baixando o arquivo de uso, um arquivo CSV (valores separados por vírgula) disponível no portal do Azure.You can retrieve information about tags by downloading the usage file, a comma-separated values (CSV) file available from the Azure portal. Para saber mais, confira Baixar ou exibir sua fatura de cobrança e dados de uso diário do Azure.For more information, see Download or view your Azure billing invoice and daily usage data. Ao baixar o arquivo de uso do Centro de Contas do Azure, selecione Versão 2.When downloading the usage file from the Azure Account Center, select Version 2. Para os serviços que dão suporte a marcas com cobrança, as marcas aparecerão na coluna Marcas.For services that support tags with billing, the tags appear in the Tags column.

Para operações de API REST, confira Referência da API REST de cobrança do Azure.For REST API operations, see Azure Billing REST API Reference.

LimitaçõesLimitations

As seguintes limitações se aplicam a marcas:The following limitations apply to tags:

  • Nem todos os tipos de recursos suportam tags.Not all resource types support tags. Para determinar se você pode aplicar uma tag a um tipo de recurso, consulte Suporte a tags para 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 assinatura podem ter um máximo de 50 pares de nome/valor de marca.Each resource, resource group, and subscription can have a maximum of 50 tag name/value pairs. Se você precisar aplicar mais marcas do que o número máximo permitido, use uma cadeia de caracteres JSON para o valor da marca.If you need to apply more tags than the maximum allowed number, use a JSON string for the tag value. A cadeia de caracteres JSON pode conter diversos valores que são aplicados a um único nome de marca.The JSON string can contain many values that are applied to a single tag name. Um grupo de recursos ou uma assinatura pode conter muitos recursos, cada um com pares de nome/valor de marca 50.A resource group or subscription can contain many resources that each have 50 tag name/value pairs.

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

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

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

    Observação

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

    A porta frontal do Azure não dá suporte ao uso de # no nome da marca.Azure Front Door doesn't support the use of # in the tag name.

    A automação do Azure e a CDN do Azure dão suporte apenas a 15 marcas em recursos.Azure Automation and Azure CDN only support 15 tags on resources.

Próximas etapasNext steps