Utilizar etiquetas para organizar os recursos do Azure e a hierarquia de gestão

Artigo
05/10/2022
17 minutos para ler

Aplica etiquetas nos seus recursos Azure, grupos de recursos e subscrições para organizá-las logicamente por valores que fazem sentido para a sua organização. Cada etiqueta é constituída por um par de nome e valor. Por exemplo, pode aplicar o nome Ambiente e o valor Produção a todos os recursos na produção.

Para 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.

As etiquetas de recursos suportam todos os serviços de acumulação de custos. Para garantir que os serviços de acumulação de custos são prestados com uma etiqueta, utilize uma das políticas de etiqueta.

Aviso

As etiquetas são armazenadas como texto simples. Nunca adicione valores sensíveis às etiquetas. Valores sensíveis podem ser expostos através de muitos métodos, incluindo relatórios de custos, comandos que devolvem as definições de etiquetas existentes, histórias de implantação, modelos exportados e registos de monitorização.

Importante

Os nomes das etiquetas são insensíveis para operações. Uma etiqueta com um nome de etiqueta, independentemente do invólucro, é atualizada ou recuperada. No entanto, o fornecedor de recursos pode manter o invólucro que fornece para o nome da etiqueta. Verá o invólucro nos relatórios de custos.

Os valores da etiqueta são sensíveis a casos.

Nota

Este artigo fornece etapas sobre como eliminar dados pessoais do dispositivo ou serviço e pode ser usado para suportar as suas obrigações no âmbito do RGPD. Para obter informações gerais sobre o RGPD, consulte a secção RGPD do Microsoft Trust Center e a secção RGPD do portal Service Trust.

Acesso obrigatório

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

Pode ter acesso ao Microsoft.Resources/tags tipo de recurso. Este acesso permite-lhe etiquetar qualquer recurso, mesmo que não tenha acesso ao próprio recurso. A função De Colaborador tag concede este acesso. Atualmente, a função de contribuinte de etiqueta não pode aplicar etiquetas a recursos ou grupos de recursos através do portal. Pode aplicar etiquetas a subscrições através do portal. Suporta todas as operações de etiquetas através do PowerShell e da API REST.
Pode ter acesso de escrita ao próprio recurso. A função Contribuinte concede o acesso necessário à aplicação de etiquetas a qualquer entidade. Para aplicar etiquetas a apenas um tipo de recurso, utilize a função de contribuinte para esse recurso. Por exemplo, para aplicar tags em máquinas virtuais, utilize o Contribuinte Máquina Virtual.

PowerShell

Aplicar tags

Azure PowerShell oferece dois comandos para aplicação de tags: New-AzTag e Update-AzTag. Deve ter o Az.Resources módulo 1.12.0 ou mais tarde. Pode verificar a sua versão com Get-InstalledModule -Name Az.Resources. Pode instalar esse módulo ou instalar Azure PowerShell 3.6.1 ou posterior.

Substitui New-AzTag todas as etiquetas no recurso, grupo de recursos ou subscrição. Ao ligar para o comando, passe na identificação de recursos da entidade que deseja marcar.

O exemplo a seguir aplica um conjunto de etiquetas 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 estiver concluído, note que o recurso tem duas etiquetas.

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.

$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á tenha etiquetas, use Update-AzTag. Desa estalem o -Operation parâmetro para 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.

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

Cada nome de etiqueta pode ter apenas um valor. Se fornecer um novo valor para uma etiqueta, o valor antigo é substituído mesmo que utilize a operação de fusão. O exemplo a seguir altera a Status etiqueta 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 se define o -Operation parâmetro para Replace, as etiquetas existentes são substituídas pelo novo conjunto de etiquetas.

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

Apenas as novas etiquetas permanecem no recurso.

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

Os mesmos comandos também funcionam com grupos de recursos ou subscrições. Você passa no identificador para o grupo de recursos ou subscrição que deseja marcar.

Para adicionar um novo conjunto de tags a um grupo de recursos, utilize:

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

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

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

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

Pode ter mais de um recurso com o mesmo nome num grupo de recursos. Nesse caso, pode 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 etiquetas para um recurso, grupo de recursos ou subscrição, use o comando Get-AzTag e passe no ID de recursos para a entidade.

Para ver as etiquetas para um recurso, use:

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

Para ver as etiquetas de um grupo de recursos, utilize:

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

Para ver as etiquetas para uma subscrição, utilize:

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

Lista por etiqueta

Para obter recursos que tenham um nome e valor específicos, 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:

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

Para obter grupos de recursos que tenham um nome e valor específicos, utilize:

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

Remover tags

Para remover etiquetas específicas, utilize Update-AzTag e desateia -Operation .Delete Passe as etiquetas que pretende apagar.

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

As etiquetas especificadas são removidas.

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

Para remover todas as etiquetas, utilize o comando Remove-AzTag .

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

CLI do Azure

Aplicar tags

O Azure CLI oferece dois comandos para a aplicação de tags: az tag create e a az tag update. Deve ter Azure CLI 2.10.0 ou mais tarde. Pode verificar a sua versão com az version. Para atualizar ou instalar, consulte instalar o Azure CLI.

Substitui az tag create todas as etiquetas no recurso, grupo de recursos ou subscrição. Ao ligar para o comando, passe na identificação de recursos da entidade que deseja marcar.

O exemplo a seguir aplica um conjunto de etiquetas 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 estiver concluído, note que o recurso tem duas etiquetas.

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

Se voltar a executar o comando, mas desta vez com etiquetas diferentes, note que as etiquetas anteriores são removidas.

az tag create --resource-id $resource --tags Team=Compliance Environment=Production

"properties": {
  "tags": {
    "Environment": "Production",
    "Team": "Compliance"
  }
},

Para adicionar tags a um recurso que já tenha etiquetas, use az tag update. Desa estalem o --operation parâmetro para Merge.

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

Note que as duas novas etiquetas foram adicionadas às duas etiquetas existentes.

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

az tag update --resource-id $resource --operation Merge --tags Status=Green

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

Quando se define o --operation parâmetro para Replace, as etiquetas existentes são substituídas pelo novo conjunto de etiquetas.

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

Apenas as novas etiquetas permanecem no recurso.

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

Os mesmos comandos também funcionam com grupos de recursos ou subscrições. Você passa no identificador para o grupo de recursos ou subscrição que deseja marcar.

Para adicionar um novo conjunto de tags a um grupo de recursos, utilize:

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

Para atualizar as etiquetas para um grupo de recursos, utilize:

az tag update --resource-id $group --operation Merge --tags CostCenter=00123 Environment=Production

Para adicionar um novo conjunto de tags a uma subscrição, utilize:

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 etiquetas para uma subscrição, utilize:

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

Para obter as etiquetas para um recurso, grupo de recursos ou subscrição, use o comando da lista de etiquetas az e passe no ID de recursos para a entidade.

Para ver as etiquetas para um recurso, use:

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

Para ver as etiquetas de um grupo de recursos, utilize:

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

Para ver as etiquetas para uma subscrição, utilize:

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

Lista por etiqueta

Para obter recursos que tenham um nome e valor específicos, use:

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

Para obter recursos que tenham um nome de identificação específico com qualquer valor de etiqueta, use:

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

Para obter grupos de recursos que tenham um nome e valor específicos, utilize:

az group list --tag Dept=Finance

Remover tags

Para remover etiquetas específicas, utilize az tag update e desateia --operation .Delete Passe as etiquetas que pretende apagar.

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

As etiquetas especificadas são removidas.

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

Para remover todas as etiquetas, utilize o comando de exclusão da marca az .

az tag delete --resource-id $resource

Espaços de manuseamento

Se os nomes ou valores da sua marca incluem espaços, inclua-os em ações duplas.

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

Modelos de ARM

Pode marcar recursos, grupos de recursos e subscrições durante a implementação com um modelo de Resource Manager Azure (modelo ARM).

Nota

As etiquetas que aplica através de um modelo ARM ou ficheiro Bicep substituem quaisquer tags existentes.

Aplicar valores

O exemplo a seguir implanta uma conta de armazenamento com três tags. Duas das etiquetas (Dept e Environment) são definidas para valores literais. Uma etiqueta (LastDeployed) é definida para um parâmetro que predefini 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

Pode definir um parâmetro de objeto que armazene várias etiquetas e aplicar esse objeto no elemento da etiqueta. Esta abordagem proporciona mais flexibilidade do que o exemplo anterior porque o objeto pode ter propriedades diferentes. Cada propriedade no objeto torna-se uma etiqueta separada para o recurso. O exemplo seguinte tem um parâmetro denominado tagValues que é aplicado no elemento da etiqueta.

JSON
Bicep

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

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

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

Aplique uma corda JSON

Para armazenar muitos valores numa única etiqueta, aplique uma cadeia JSON que represente os valores. Toda a cadeia JSON é armazenada como uma etiqueta que não pode exceder 256 caracteres. O exemplo seguinte tem uma única etiqueta com o nome CostCenter que contém vários valores de uma cadeia 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 tags do grupo de recursos

Para aplicar tags de um grupo de recursos a um recurso, utilize a função Grupo de Recursos() 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.

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 tags em grupos de recursos ou subscrições

Pode adicionar tags a um grupo de recursos ou subscrição através da implementação do Microsoft.Resources/tags tipo de recurso. As etiquetas são aplicadas ao grupo de recursos-alvo ou subscrição para a implementação. Cada vez que implementa o modelo substitui quaisquer tags, foram previamente aplicadas.

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 etiquetas num grupo de recursos, utilize o PowerShell ou o Azure CLI. Implemente para o grupo de recursos que pretende 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 etiquetas numa subscrição, utilize o PowerShell ou o Azure CLI. Implemente a subscrição que pretende 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 obter mais informações sobre as implementações de subscrição, consulte Criar grupos de recursos e recursos ao nível da subscrição.

O modelo a seguir adiciona as tags de um objeto a um grupo de recursos ou a uma subscrição.

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 utilizador não tiver o acesso necessário para a aplicação de tags, pode atribuir a função de Colaborador tag ao utilizador. Para obter mais informações, consulte Tutorial: Conceder a um utilizador acesso aos recursos do Azure utilizando o RBAC e o portal do Azure.

Para visualizar as etiquetas para um recurso ou um grupo de recursos, procure etiquetas existentes na visão geral. Se não tiver aplicado etiquetas anteriormente, a lista estará vazia.
Para adicionar uma etiqueta, selecione Clique aqui para adicionar tags.
Forneça um nome e valor.
Continue a adicionar etiquetas conforme necessário. Quando terminar, selecione Guardar.
As etiquetas são agora apresentadas no panorama geral.
Para adicionar ou eliminar uma etiqueta, selecione alterar.
Para eliminar uma etiqueta, selecione o ícone do lixo. Em seguida, selecione Save.

Para atribuir etiquetas a granel a múltiplos recursos:

A partir de qualquer lista de recursos, selecione a caixa de verificação para os recursos que pretende atribuir à etiqueta. Em seguida, selecione 'Atribuir tags'.
Adicione nomes e valores. Quando terminar, selecione Guardar.

Para ver todos os recursos com uma etiqueta:

No menu portal do Azure, procure etiquetas. Selecione-o nas opções disponíveis.
Selecione a etiqueta para visualizar recursos.
Todos os recursos com esta etiqueta são exibidos.

API REST

Para trabalhar com tags através da API Azure REST, utilize:

Tags - Criar ou atualizar no âmbito (operação PUT)
Tags - Atualização no Âmbito (operação PATCH)
Tags - Get At Scope (operação GET)
Tags - Excluir no âmbito (operação DELETE)

SDKs

Para amostras de etiquetas de aplicação com SDKs, consulte:

Herdar etiquetas

As etiquetas aplicadas ao grupo de recursos ou à subscrição não são herdadas pelos recursos. Para aplicar tags de um grupo de subscrição ou de recursos aos recursos, consulte Azure Policies - tags.

Etiquetas e faturação

Pode utilizar etiquetas para agrupar os seus dados de faturação. 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. 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.

Pode obter informações sobre tags descarregando o ficheiro de utilização, um ficheiro de valores separados por vírgula (CSV) disponível a partir do portal do Azure. Para obter mais informações, veja Transferir ou ver a fatura e os dados de utilização diária do Azure. Para serviços que suportam etiquetas com faturação, as etiquetas aparecem na coluna Tags .

Para operações rest API, consulte referência API A API de Faturação AZure.

Limitações

As seguintes limitações aplicam-se às etiquetas:

Nem todos os tipos de recursos suportam tags. Para determinar se pode aplicar uma etiqueta a um tipo de recurso, consulte o suporte da Tag para os recursos do Azure.
Cada recurso, grupo de recursos e subscrição podem ter um máximo de 50 pares de nome/valor de etiqueta. Se precisar de aplicar mais etiquetas do que o número máximo permitido, utilize uma corda JSON para o valor da etiqueta. A cadeia JSON pode conter muitos valores que são aplicados a um nome de etiqueta individual. Um grupo de recursos ou subscrição pode conter muitos recursos que cada um tem 50 pares de nome/valor de tag.
O nome de etiqueta está limitado a 512 caracteres e o valor a 256. Nas contas de armazenamento, o nome da etiqueta está limitado a 128 caracteres e o valor a 256.
As etiquetas não podem ser aplicadas a recursos clássicos como Serviços Cloud.
Os Grupos IP do Azure e as Políticas de Azure Firewall não suportam operações PATCH, o que significa que não suportam a atualização de tags através do portal. Em vez disso, utilize os comandos de atualização para esses recursos. Por exemplo, pode atualizar tags para um grupo IP com o comando de atualização ip-group da rede Az .
Os nomes da etiqueta não podem conter estes caracteres: <, >, %, &, , \, ?/
Nota
- As zonas Azure DNS não suportam a utilização de espaços na etiqueta ou uma etiqueta que comece com um número. Os nomes de tags Azure DNS não suportam caracteres especiais e unicode. O valor pode conter todos os caracteres.
- Gestor de Tráfego não suporta o uso de espaços, # ou : no nome da etiqueta. O nome da etiqueta não pode começar com um número.
- A porta frontal azul não suporta o uso # de ou : no nome da etiqueta.
- Os seguintes recursos Azure suportam apenas 15 tags:
  - Automatização do Azure
  - CDN do Azure
  - Azure DNS (Zone and A records)
  - Azure DNS Privado (Zone, A records e virtual network link)

Passos seguintes

Nem todos os tipos de recursos suportam tags. Para determinar se pode aplicar uma etiqueta a um tipo de recurso, consulte o suporte da Tag para os recursos do Azure.
Para 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.

Utilizar etiquetas para organizar os recursos do Azure e a hierarquia de gestão

Esta página é útil?

Acesso obrigatório

PowerShell

Aplicar tags

Listar etiquetas

Lista por etiqueta

Remover tags

CLI do Azure

Aplicar tags

Listar etiquetas

Lista por etiqueta

Remover tags

Espaços de manuseamento

Modelos de ARM

Aplicar valores

Aplicar um objeto

Aplique uma corda JSON

Aplicar tags do grupo de recursos

Aplicar tags em grupos de recursos ou subscrições

Portal

API REST

SDKs

Herdar etiquetas

Etiquetas e faturação

Limitações

Passos seguintes