Use marcas para organizar os recursos do Azure e a hierarquia de gerenciamento

Artigo
03/25/2023
18 minutos para o fim da leitura

Marcas são elementos de metadados que você aplica aos recursos do Azure. Elas são pares chave-valor que ajudam você a identificar recursos com base em configurações relevantes para sua organização. Se quiser acompanhar o ambiente de implantação para seus recursos, adicione uma chave chamada Ambiente. Para identificar os recursos implantados na produção, dê a eles um valor de Produção. Totalmente formado, o par chave-valor torna-se, Ambiente = Produção.

Você pode aplicar marcas aos recursos, grupos de recursos e assinaturas do Azure para organizá-los.

Para obter recomendações sobre como implementar uma estratégia de marcação, consulte Guia de decisão de nomenclatura e marcação de recursos.

As marcações de recurso dão suporte a todos os serviços de acúmulo de custos. Para garantir que os serviços geradores de custos sejam provisionados com uma marca, use uma das políticas de marca.

Aviso

As marcações são armazenadas como texto sem formatação. Jamais adicione valores confidenciais às marcações. Valores confidenciais podem ser expostos por meio de muitos métodos, incluindo relatórios de custo, comandos que retornam as definições de marca existentes, históricos de implantação, modelos exportados e logs de monitoramento.

Aviso

Tenha cuidado ao usar um idioma que não seja o inglês nas marcas. Isso poderá causar uma falha no progresso da decodificação ao carregar os metadados da VM do IMDS (Serviço de Metadados de Instância).

Importante

Os nomes de marca não diferenciam maiúsculas de minúsculas para operações. Uma marca com um nome de marca, independentemente de maiúsculas e minúsculas, será atualizada ou recuperada. No entanto, o provedor de recursos pode manter a capitalização fornecida por você para o nome da marca. Essa capitalização será exibida nos relatórios de custo.

Os valores da marca diferenciam maiúsculas de minúsculas.

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. Para obter informações gerais sobre o GDPR, confira a seção GDPR da Central de Confiabilidade da Microsoft e a seção GDPR do Portal de Confiança do Serviço.

Acesso necessário

Há duas maneiras de obter o acesso necessário aos recursos de marcação.

É possível ter acesso de gravação ao tipo de recurso Microsoft.Resources/tags. Esse acesso permite marcar qualquer recurso, mesmo que você não tenha acesso ao recurso em si. A função de Colaborador de marcação concede esse acesso. Por exemplo, a função de colaborador de marcação não pode aplicar marcas a recursos ou grupos de recursos por meio do Portal. Ela pode, no entanto, aplicar marcas às assinaturas por meio do Portal. Ele dá suporte a todas as operações de marcação por meio do Azure PowerShell e da API REST.
É possível ter acesso de gravação ao recurso em si. A função Colaborador concede o acesso necessário para aplicar marcas a qualquer entidade. Para aplicar marcas a apenas um tipo de recurso, use a função de colaborador para esse recurso. Para aplicar marcas a máquinas virtuais, por exemplo, use o Colaborador da Máquina Virtual.

PowerShell

Aplicar marcas

O Azure PowerShell oferece dois comandos para aplicar marcas: New-AzTag e Update-AzTag. Você precisa ter a versão 1.12.0 do módulo Az.Resources ou posterior. É possível verificar sua versão atual com Get-InstalledModule -Name Az.Resources. Pode ser instalado aquele módulo ou instalar o Azure PowerShell versão 3.6.1 ou posterior.

O New-AzTag substitui todas as marcas no recurso, no grupo de recursos ou na assinatura. Ao chamar do comando, passe a ID de recurso da entidade que deseja marcar.

O exemplo a seguir aplica um conjunto de marcas a uma conta de armazenamento:

$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 terá duas marcas.

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

Se executar o comando novamente, mas desta vez com marcas diferentes, observe que as marcas anteriores desaparecem.

$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. Defina o parâmetro de -Operation a Merge.

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

Observe que as marcas existentes crescem com a adição das duas novas marcas.

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

Cada nome de marca pode ter apenas um valor. Se você fornecer um novo valor para uma marca, ele substituirá o valor antigo mesmo que você use a operação de mesclagem. O exemplo a seguir altera a marca de Status de Normal para Verde.

$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, o novo conjunto de marcas substitui as marcas existentes.

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

Somente as novas marcas permanecem no recurso.

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

Os mesmos comandos também funcionam com grupos de recursos ou assinaturas. Passe-os no identificador do grupo de recursos ou assinatura que deseja marcar.

Para adicionar um novo conjunto de marcas a um grupo de recursos, use:

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

Para atualizar as marcas para um grupo de recursos, 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:

$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:

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

É possível ter mais de um recurso com o mesmo nome em um grupo de recursos. Nesse caso, é possível definir cada recurso com os seguintes comandos:

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

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.

Para consultar as marcas para um tipo de recurso, use:

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

Para consultar as marcas para um grupo de recursos, use:

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

Para consultar as marcas de uma assinatura, use:

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

Listar por marca

Para obter recursos que têm um nome e valor de marca específicos, use:

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

Para obter recursos que têm um nome específico e um valor de marca qualquer, use:

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

Para obter grupos recursos que têm um nome e valor de marca específicos, use:

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

Remover Marcas

Para remover marcas específicas, use Update-AzTag e defina -Operation como Delete. Passe as IDs de recurso das marcas que deseja excluir.

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

As marcas especificadas são removidas.

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

Para remover todas as marcas, use o comando Remove-AzTag.

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

CLI do Azure

Aplicar marcas

O CLI do Azure oferece dois comandos para aplicar marcas: az tag Create e az tag update. Você precisa ter a versão 2.10.0 da CLI do Azure ou posterior. É possível verificar sua versão atual com az version. Para atualizar ou instalar, consulte Instalar a CLI do Azure.

O az tag create substitui todas as marcas no recurso, no grupo de recursos ou na assinatura. Ao chamar do comando, passe a ID de recurso da entidade que deseja marcar.

O exemplo a seguir aplica um conjunto de marcas a uma conta de armazenamento:

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 terá duas marcas.

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

Se executar o comando novamente, mas desta vez com marcas diferentes, observe que as marcas anteriores desaparecem.

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. Defina o parâmetro de --operation a Merge.

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

Observe que as marcas existentes crescem com a adição das duas novas marcas.

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

Cada nome de marca pode ter apenas um valor. Se você fornecer um novo valor para uma marca, a nova marca substituirá o valor antigo mesmo que você use a operação de mesclagem. O exemplo a seguir altera a marca de Status de Normal para Verde.

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 parâmetro --operation como Replace, o novo conjunto de marcas substitui as marcas existentes.

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

Somente as novas marcas permanecem no recurso.

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

Os mesmos comandos também funcionam com grupos de recursos ou assinaturas. Passe-os no identificador do grupo de recursos ou assinatura que deseja marcar.

Para adicionar um novo conjunto de marcas a um grupo de recursos, use:

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

Para atualizar as marcas para um grupo de recursos, 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:

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:

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

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.

Para consultar as marcas para um tipo de recurso, use:

resource=$(az resource show -g demoGroup -n demoStorage --resource-type Microsoft.Storage/storageAccounts --query "id" --output tsv)
az tag list --resource-id $resource

Para consultar as marcas para um grupo de recursos, use:

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

Para consultar as marcas de uma assinatura, use:

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

Listar por marca

Para obter recursos que têm um nome e valor de marca específicos, use:

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

Para obter recursos que têm um nome específico e um valor de marca qualquer, use:

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

Para obter grupos recursos que têm um nome e valor de marca específicos, use:

az group list --tag Dept=Finance

Remover Marcas

Para remover marcas específicas, use az tag update e defina --operation como Delete. Passe a ID de recurso das marcas que deseja excluir.

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

Você removeu as marcas especificadas.

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

Para remover todas as marcas, use o comando az tag delete.

az tag delete --resource-id $resource

Espaços de manuseio

Se os nomes ou valores de marcação incluírem espaços, coloque-os entre aspas.

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

Modelos de ARM

É possível marcar recursos, grupos de recursos e assinaturas durante a implantação com um modelo do ARM.

Observação

As marcas aplicadas por meio de um modelo ARM ou arquivo Bicep substituem todas as marcas existentes.

Aplicar valores

O exemplo a seguir implanta uma conta de armazenamento com três marcas. Duas das marcas (Dept e Environment) são definidas como valores literais. Uma marca (LastDeployed) é definida como um parâmetro que usa como padrão a data atual.

JSON
Bicep

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

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

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

Aplicar um objeto

Você pode definir um parâmetro de objeto que armazena várias marcas e aplicar esse objeto para o elemento de marca. Essa abordagem fornece mais flexibilidade do que o exemplo anterior porque o objeto pode ter propriedades diferentes. Cada propriedade no objeto se torna uma marca separada para o recurso. O exemplo a seguir tem um parâmetro chamado tagValues que é aplicado ao elemento de marca.

JSON
Bicep

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

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

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

Aplicar uma cadeia de caracteres JSON

Para armazenar diversos valores em uma única marca, aplica uma cadeia de caracteres JSON que representa os valores. A cadeia de caracteres JSON inteira é armazenada como uma marca que não pode exceder 256 caracteres. O exemplo a seguir tem uma única marca denominada CostCenter que contém vários valores de uma cadeia de caracteres JSON:

JSON
Bicep

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

param location string = resourceGroup().location

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

Aplicar marcas do grupo de recursos

Para aplicar marcas de um grupo de recursos a um recurso, use a função resourceGroup(). Ao obter o valor da marca, use a sintaxe tags[tag-name] em vez da sintaxe tags.tag-name, porque alguns caracteres não são analisados corretamente na notação de ponto.

JSON
Bicep

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

param location string = resourceGroup().location

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

Aplicar marcas a grupos de recursos ou assinaturas

É possível adicionar marcas a um grupo de recursos ou assinatura implantando o tipo de recurso Microsoft.Resources/tags. Você pode aplicar as marcas ao grupo de recursos de destino ou à assinatura que deseja implantar. Cada vez que implantar o modelo, você substitui as marcas anteriores.

JSON
Bicep

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

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

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

Para aplicar as marcas a um grupo de recursos, use o Azure PowerShell ou CLI do Azure. Implante para o grupo de recursos que deseja marcar.

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. Implante para a assinatura que deseja marcar.

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 saber mais sobre as implantações de assinatura, consulte Criar grupos de recursos e recursos no nível da assinatura.

O modelo a seguir adiciona as marcas de um objeto a um grupo de recursos ou assinatura.

JSON
Bicep

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

targetScope = 'subscription'

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

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

Portal

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. Para saber mais, confira Tutorial: Conceder acesso aos recursos do Azure para um usuário usando o RBAC e o portal do Azure.

Para exibir as marcas de um recurso ou de um grupo de recursos, procure marcas existentes na visão geral. Se você não tiver aplicado marcas anteriormente, a lista estará vazia.
Para adicionar uma marca, selecione Clique aqui para adicionar marcas.
Forneça um nome e valor.
Continue adicionando marcas conforme necessário. Ao terminar, escolha Salvar.
As marcas são exibidas agora na visão geral.
Para adicionar ou excluir uma marca, selecione alterar.
Para excluir uma marca, selecione o ícone de lixeira. Em seguida, selecione Salvar.

Para atribuir marcas em massa para vários recursos:

A partir de qualquer lista de recursos, selecione a caixa de seleção para os recursos aos quais você deseja atribuir a marca. Em seguida, selecione Atribuir marcas.
Adicionar valores e nomes. Ao terminar, escolha Salvar.

Para exibir todos os recursos com uma marca:

No menu do portal do Azure, pesquise marcas. Selecione-as entre as opções disponíveis.
Selecione a marca para recursos de visualização.
Todos os recursos com essa marca são exibidos.

API REST

Para trabalhar com marcas por meio da API REST do Azure, use:

Marcas – criar ou atualizar no escopo (operação PUT)
Marcas – atualizar no escopo (operação de PATCH)
Marcas – obter no escopo (operação GET)
Marcas – excluir no escopo (operação DELETE)

SDKs

Para ver exemplos de aplicação de marcas com SDKs, confira:

Herdar marcas

Os recursos não herdam as marcas que você aplica a um grupo de recursos ou a uma assinatura. Para aplicar marcas de uma assinatura ou grupo de recursos aos recursos, consulte Políticas do Azure – marcas.

Marcas e cobrança

Você pode usar marcas para agrupar os dados de cobrança. Se estiver executando várias VMs para organizações diferentes, por exemplo, use marcas para agrupar o uso por centro de custo. 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.

É possível recuperar informações sobre marcas baixando o arquivo de uso disponível no portal do Azure. Para saber mais, confira Baixar ou exibir sua fatura de cobrança e dados de uso diário do Azure. Para os serviços que dão suporte a marcas com cobrança, as marcas aparecerão na coluna Marcas.

Para operações de API REST, confira Referência da API REST de cobrança do Azure.

Limitações

As seguintes limitações se aplicam a marcas:

Nem todos os tipos de recursos suportam tags. Para determinar se você pode aplicar uma tag a um tipo de recurso, consulte Suporte a tags para recursos do Azure.
Cada recurso, grupo de recursos ou assinatura pode ter um máximo de 50 pares de nome/valor de marca. Se precisar aplicar mais marcas do que o número máximo permitido, use uma cadeia de caracteres JSON para o valor da marca. A cadeia de caracteres JSON pode conter diversos valores que você aplica a um só nome de marca. Um grupo de recursos ou assinatura pode conter muitos recursos que possuem 50 pares de nome/valor de marca.
O nome da marca tem um limite de 512 caracteres e o valor da marca tem um limite de 256 caracteres. Para contas de armazenamento, o nome da marca tem um limite de 128 caracteres e o valor da marca tem um limite de 256 caracteres.
Recursos clássicos como Serviços de Nuvem não dão suporte a marcas.
Os Grupos de IP do Azure e as Políticas de Firewall do Azure não dão suporte a operações de PATCH. Operações de método de API PATCH, portanto, não podem atualizar marcas por meio do portal. Em vez disso, você pode usar os comandos de atualização para esses recursos. Você pode atualizar um grupo IP usando, por exemplo, o comando az network ip-group update.
Os nomes das marcas não podem conter esses caracteres: <, >, %, &, \, ?, /
Observação
- As zonas DNS (Sistema de Nomes de Domínio) do Azure não dão suporte ao uso de espaços na marca ou a uma marca que comece com um número. Nomes de marcação de DNS do Azure não são compatíveis com caracteres unicode e especiais. O valor pode conter todos os caracteres.
- O Gerenciador de Tráfego não dá suporte ao uso de espaços, # ou : no nome da marca. O nome da marca não pode começar com um número.
- O Azure Front Door não dá suporte ao uso de # ou : no nome da marca.
- Os recursos do Azure abaixo dão suporte apenas a 15 marcas:
  - Automação do Azure
  - CDN (Rede de Distribuição de Conteúdo do Azure)
  - DNS do Azure (Zona e registros A)
  - Pesquisa Salva pela Análise de Logs do Azure

Próximas etapas

Nem todos os tipos de recursos suportam tags. Para determinar se você pode aplicar uma tag a um tipo de recurso, consulte Suporte a tags para recursos do Azure.
Para obter recomendações sobre como implementar uma estratégia de marcação, consulte Guia de decisão de nomenclatura e marcação de recursos.

Use marcas para organizar os recursos do Azure e a hierarquia de gerenciamento

Acesso necessário

PowerShell

Aplicar marcas

Listar por marca

Remover Marcas

CLI do Azure

Aplicar marcas

Listar por marca

Remover Marcas

Espaços de manuseio

Modelos de ARM

Aplicar valores

Aplicar um objeto

Aplicar uma cadeia de caracteres JSON

Aplicar marcas do grupo de recursos

Aplicar marcas a grupos de recursos ou assinaturas

Portal

API REST

SDKs

Herdar marcas

Marcas e cobrança

Limitações

Próximas etapas

Recursos adicionais

Recursos adicionais

Use marcas para organizar os recursos do Azure e a hierarquia de gerenciamento

Acesso necessário

PowerShell

Aplicar marcas

Listar marcas

Listar por marca

Remover Marcas

CLI do Azure

Aplicar marcas

Listar marcas

Listar por marca

Remover Marcas

Espaços de manuseio

Modelos de ARM

Aplicar valores

Aplicar um objeto

Aplicar uma cadeia de caracteres JSON

Aplicar marcas do grupo de recursos

Aplicar marcas a grupos de recursos ou assinaturas

Portal

API REST

SDKs

Herdar marcas

Marcas e cobrança

Limitações

Próximas etapas

Recursos adicionais

Recursos adicionais