Tags gebruiken om uw Azure-resources en beheerhiërarchie te organiseren

Artikel
03/25/2023
17 minuten om te lezen

Tags zijn metagegevenselementen die u toepast op uw Azure-resources. Het zijn sleutel-waardeparen waarmee u resources kunt identificeren op basis van instellingen die relevant zijn voor uw organisatie. Als u de implementatieomgeving voor uw resources wilt bijhouden, voegt u een sleutel toe met de naam Omgeving. Als u de resources wilt identificeren die voor productie zijn geïmplementeerd, geeft u deze de waarde Productie. Volledig gevormd, wordt het sleutel-waardepaar, Omgeving = Productie.

U kunt tags toepassen op uw Azure-resources, resourcegroepen en abonnementen.

Zie Resource naming and tagging decision guide (Handleiding voor het nemen van namen en taggen van resources) voor aanbevelingen over het implementeren van een tagstrategie.

Resourcetags ondersteunen alle kostentoerekeningsservices. Gebruik een van de tagbeleidsregels om ervoor te zorgen dat kostenverlenende services worden ingericht met een tag.

Waarschuwing

Tags worden opgeslagen als tekst zonder opmaak. Voeg nooit gevoelige waarden toe aan tags. Gevoelige waarden kunnen worden weergegeven via een groot aantal methoden, waaronder kostenrapporten, opdrachten die bestaande tagdefinities retourneren, implementatiegeschiedenis, geëxporteerde sjablonen en bewakingslogboeken.

Waarschuwing

Wees voorzichtig bij het gebruik van een niet-Engelse taal in uw tags. Dit kan leiden tot een fout bij het decoderen van de voortgang tijdens het laden van de metagegevens van uw VM vanuit IMDS (Instance Metadata Service).

Belangrijk

Tagnamen zijn niet hoofdlettergevoelig voor bewerkingen. Een tag met een tagnaam, ongeacht de behuizing, wordt bijgewerkt of opgehaald. De resourceprovider kan echter het hoofdlettergebruik behouden dat u opgeeft voor de tagnaam. U ziet die hoofdletters in kostenrapporten.

Tagwaarden zijn hoofdlettergevoelig.

Notitie

Dit artikel bevat stappen voor het verwijderen van persoonlijke gegevens van het apparaat of de service. U kunt het ook gebruiken om uw verplichtingen met betrekking tot de AVG (Algemene Verordening Gegevensbescherming) na te komen. Zie de AVG-sectie van het Vertrouwenscentrum van Microsoft en de AVG-sectie van de Service Trust-portal voor algemene informatie over de AVG.

Vereiste toegang

Er zijn twee manieren waarop u de vereiste toegang tot tagresources kunt verkrijgen.

U kunt schrijftoegang hebben tot het Microsoft.Resources/tags resourcetype. Met deze toegang kunt u elke resource taggen, zelfs als u geen toegang hebt tot de resource zelf. De rol Tagbijdrager verleent deze toegang. De rol tagbijdrager kan bijvoorbeeld geen tags toepassen op resources of resourcegroepen via de portal. De rol kan echter wel via de portal tags toepassen op abonnementen. De rol ondersteunt alle tagbewerkingen via Azure PowerShell en de REST API.
U kunt schrijftoegang hebben tot de resource zelf. De rol Inzender verleent de vereiste toegang om tags toe te passen op een entiteit. Als u tags wilt toepassen op slechts één resourcetype, gebruikt u de rol Inzender voor die resource. Als u bijvoorbeeld tags wilt toepassen op virtuele machines, gebruikt u de inzender voor virtuele machines.

PowerShell

Tags toepassen

Azure PowerShell biedt twee opdrachten om tags toe te passen: New-AzTag en Update-AzTag. U moet de Az.Resources versie van module 1.12.0 of hoger hebben. U kunt uw versie controleren met Get-InstalledModule -Name Az.Resources. U kunt deze module installeren of Azure PowerShell versie 3.6.1 of hoger installeren.

De New-AzTag vervangt alle tags in de resource, resourcegroep of het abonnement. Wanneer u de opdracht aanroept, geeft u de resource-id door van de entiteit die u wilt taggen.

In het volgende voorbeeld wordt een set tags toegepast op een opslagaccount:

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resource = Get-AzResource -Name demoStorage -ResourceGroup demoGroup
New-AzTag -ResourceId $resource.id -Tag $tags

Wanneer de opdracht is voltooid, ziet u dat de resource twee tags heeft.

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

Als u de opdracht opnieuw uitvoert, maar deze keer met verschillende tags, ziet u dat de eerdere tags verdwijnen.

$tags = @{"Team"="Compliance"; "Environment"="Production"}
New-AzTag -ResourceId $resource.id -Tag $tags

Properties :
        Name         Value
        ===========  ==========
        Environment  Production
        Team         Compliance

Als u tags wilt toevoegen aan een resource die al tags bevat, gebruikt u Update-AzTag. Stel de -Operation parameter in op Merge.

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

U ziet dat de bestaande tags groter worden met de toevoeging van de twee nieuwe tags.

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

Elke tagnaam kan slechts één waarde hebben. Als u een nieuwe waarde opgeeft voor een tag, vervangt deze de oude waarde, zelfs als u de samenvoegbewerking gebruikt. In het volgende voorbeeld wordt de Status tag gewijzigd van Normaal in Groen.

$tags = @{"Status"="Green"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge

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

Wanneer u de -Operation parameter instelt op Replace, vervangt de nieuwe set tags de bestaande tags.

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

Alleen de nieuwe tags blijven over in de resource.

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

Dezelfde opdrachten werken ook met resourcegroepen of abonnementen. Geef ze door in de id van de resourcegroep of het abonnement dat u wilt taggen.

Als u een nieuwe set tags wilt toevoegen aan een resourcegroep, gebruikt u:

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

Als u de tags voor een resourcegroep wilt bijwerken, gebruikt u:

$tags = @{"CostCenter"="00123"; "Environment"="Production"}
$resourceGroup = Get-AzResourceGroup -Name demoGroup
Update-AzTag -ResourceId $resourceGroup.ResourceId -Tag $tags -Operation Merge

Als u een nieuwe set tags wilt toevoegen aan een abonnement, gebruikt u:

$tags = @{"CostCenter"="00123"; "Environment"="Dev"}
$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
New-AzTag -ResourceId "/subscriptions/$subscription" -Tag $tags

Als u de tags voor een abonnement wilt bijwerken, gebruikt u:

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

Mogelijk hebt u meer dan één resource met dezelfde naam in een resourcegroep. In dat geval kunt u elke resource instellen met de volgende opdrachten:

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

Als u de tags voor een resource, resourcegroep of abonnement wilt ophalen, gebruikt u de opdracht Get-AzTag en geeft u de resource-id van de entiteit door.

Als u de tags voor een resource wilt zien, gebruikt u:

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

Als u de tags voor een resourcegroep wilt zien, gebruikt u:

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

Als u de tags voor een abonnement wilt zien, gebruikt u:

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

Lijst op label

Als u resources met een specifieke tagnaam en -waarde wilt ophalen, gebruikt u:

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

Als u resources wilt ophalen met een specifieke tagnaam met een tagwaarde, gebruikt u:

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

Als u resourcegroepen wilt ophalen die een specifieke tagnaam en -waarde hebben, gebruikt u:

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

Tags verwijderen

Als u specifieke tags wilt verwijderen, gebruikt Update-AzTag u en stelt u in -Operation op Delete. Geef de resource-id's door van de tags die u wilt verwijderen.

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

De opgegeven tags worden verwijderd.

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

Als u alle tags wilt verwijderen, gebruikt u de opdracht Remove-AzTag .

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

Azure CLI

Tags toepassen

Azure CLI biedt twee opdrachten om tags toe te passen: az tag create en az tag update. U moet de Azure CLI 2.10.0-versie of hoger hebben. U kunt uw versie controleren met az version. Zie De Azure CLI installeren om deze bij te werken of te installeren.

De az tag create vervangt alle tags in de resource, resourcegroep of het abonnement. Wanneer u de opdracht aanroept, geeft u de resource-id door van de entiteit die u wilt taggen.

In het volgende voorbeeld wordt een set tags toegepast op een opslagaccount:

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

Wanneer de opdracht is voltooid, ziet u dat de resource twee tags heeft.

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

Als u de opdracht opnieuw uitvoert, maar deze keer met verschillende tags, ziet u dat de eerdere tags verdwijnen.

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

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

Als u tags wilt toevoegen aan een resource die al tags bevat, gebruikt u az tag update. Stel de --operation parameter in op Merge.

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

U ziet dat de bestaande tags groter worden met de toevoeging van de twee nieuwe tags.

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

Elke tagnaam kan slechts één waarde hebben. Als u een nieuwe waarde opgeeft voor een tag, vervangt de nieuwe tag de oude waarde, zelfs als u de samenvoegbewerking gebruikt. In het volgende voorbeeld wordt de Status tag gewijzigd van Normaal in Groen.

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

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

Wanneer u de --operation parameter instelt op Replace, vervangt de nieuwe set tags de bestaande tags.

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

Alleen de nieuwe tags blijven over in de resource.

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

Dezelfde opdrachten werken ook met resourcegroepen of abonnementen. Geef deze door in de id van de resourcegroep of het abonnement dat u wilt taggen.

Als u een nieuwe set tags wilt toevoegen aan een resourcegroep, gebruikt u:

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

Als u de tags voor een resourcegroep wilt bijwerken, gebruikt u:

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

Als u een nieuwe set tags aan een abonnement wilt toevoegen, gebruikt u:

sub=$(az account show --subscription "Demo Subscription" --query id --output tsv)
az tag create --resource-id /subscriptions/$sub --tags CostCenter=00123 Environment=Dev

Als u de tags voor een abonnement wilt bijwerken, gebruikt u:

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

Als u de tags voor een resource, resourcegroep of abonnement wilt ophalen, gebruikt u de opdracht az tag list en geeft u de resource-id van de entiteit door.

Als u de tags voor een resource wilt zien, gebruikt u:

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

Als u de tags voor een resourcegroep wilt zien, gebruikt u:

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

Als u de tags voor een abonnement wilt zien, gebruikt u:

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

Lijst per tag weergeven

Als u resources met een specifieke tagnaam en -waarde wilt ophalen, gebruikt u:

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

Als u resources met een specifieke tagnaam met een willekeurige tagwaarde wilt ophalen, gebruikt u:

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

Als u resourcegroepen met een specifieke tagnaam en -waarde wilt ophalen, gebruikt u:

az group list --tag Dept=Finance

Tags verwijderen

Als u specifieke tags wilt verwijderen, gebruikt az tag update u en stelt u in --operation op Delete. Geef de resource-id door van de tags die u wilt verwijderen.

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

U hebt de opgegeven tags verwijderd.

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

Als u alle tags wilt verwijderen, gebruikt u de opdracht az tag delete .

az tag delete --resource-id $resource

Afhandeling van ruimten

Als uw tagnamen of -waarden spaties bevatten, plaatst u deze tussen aanhalingstekens.

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

ARM-sjablonen

U kunt resources, resourcegroepen en abonnementen tijdens de implementatie taggen met een ARM-sjabloon.

Notitie

De tags die u toepast via een ARM-sjabloon of Bicep-bestand overschrijven alle bestaande tags.

Waarden toepassen

In het volgende voorbeeld wordt een opslagaccount met drie tags geïmplementeerd. Twee van de tags (Dept en Environment) zijn ingesteld op letterlijke waarden. Eén tag (LastDeployed) is ingesteld op een parameter die standaard de huidige datum heeft.

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
  }
}

Een object toepassen

U kunt een objectparameter definiëren waarin verschillende tags worden opgeslagen en dat object toepassen op het tag-element. Deze benadering biedt meer flexibiliteit dan in het vorige voorbeeld, omdat het object verschillende eigenschappen kan hebben. Elke eigenschap in het object wordt een afzonderlijke tag voor de resource. Het volgende voorbeeld bevat een parameter met de naam tagValues die wordt toegepast op het tag-element.

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
}

Een JSON-tekenreeks toepassen

Als u veel waarden wilt opslaan in een enkele tag, past u een JSON-tekenreeks toe die de waarden vertegenwoordigt. De hele JSON-tekenreeks wordt opgeslagen als één tag die niet langer mag zijn dan 256 tekens. Het volgende voorbeeld heeft een enkele tag met de naam CostCenter die verschillende waarden uit een JSON-tekenreeks bevat:

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"}'
  }
}

Tags toepassen vanuit resourcegroep

Als u tags van een resourcegroep wilt toepassen op een resource, gebruikt u de functie resourceGroup(). Wanneer u de tagwaarde krijgt, gebruikt u de tags[tag-name] syntaxis in plaats van de tags.tag-name syntaxis, omdat sommige tekens niet correct worden geparseerd in de puntnotatie.

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']
  }
}

Tags toepassen op resourcegroepen of abonnementen

U kunt tags toevoegen aan een resourcegroep of abonnement door het Microsoft.Resources/tags resourcetype te implementeren. U kunt de tags toepassen op de doelresourcegroep of het abonnement dat u wilt implementeren. Telkens wanneer u de sjabloon implementeert, vervangt u eventuele eerdere tags.

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
    }
  }
}

Als u de tags wilt toepassen op een resourcegroep, gebruikt u Azure PowerShell of Azure CLI. Implementeer naar de resourcegroep die u wilt taggen.

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

Als u de tags wilt toepassen op een abonnement, gebruikt u PowerShell of Azure CLI. Implementeer naar het abonnement dat u wilt taggen.

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

Zie Resourcegroepen en resources maken op abonnementsniveau voor meer informatie over abonnementsimplementaties.

Met de volgende sjabloon worden de tags van een object toegevoegd aan een resourcegroep of abonnement.

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

Als een gebruiker niet beschikt over de vereiste toegang voor het toepassen van tags, kunt u de rol Inzender van tag toewijzen aan de gebruiker. Zie Zelfstudie: Verleen een gebruiker toegang tot Azure-resources verlenen met behulp van RBAC en Azure Portal.

Als u de tags voor een resource of resourcegroep wilt weergeven, selecteert u het pictogram Tags in het overzicht. Als u nog niet eerder tags hebt toegepast, is de lijst leeg.
Als u een tag wilt toevoegen, selecteert u Klik hier om tags toe te voegen.
Geef een naam en waarde op.
Ga verder met het toevoegen van tags als dat nodig is. Selecteer Opslaan wanneer u klaar bent.
De tags worden nu weergegeven in het overzicht.
Selecteer wijzigenom een tag toe te voegen of te verwijderen.
Als u een tag wilt verwijderen, selecteert u het prullenbakpictogram. Selecteer vervolgens Opslaan.

Tags bulksgewijs toewijzen aan meerdere resources:

Schakel in een lijst met resources het selectievakje in voor de resources die u wilt toewijzen aan de tag. Selecteer Tags toewijzen.
Voeg een naam en waarde toe. Selecteer Opslaan wanneer u klaar bent.

Alle resources met een tag weergeven:

Zoek in het menu Azure Portal naar Tags. Selecteer Tags bij de beschikbare opties.
Selecteer de tag om de resources weer te geven.
Alle resources met die tag worden weergegeven.

REST-API

Als u met tags wilt werken via de Azure REST API, gebruikt u:

Tags: maken of bijwerken op bereik (PUT-bewerking)
Tags - Bijwerken bij bereik (PATCH-bewerking)
Tags - Get At Scope (GET-bewerking)
Tags - Verwijderen bij bereik (DELETE-bewerking)

SDK's

Zie voor voorbeelden van het toepassen van tags met SDK's:

Tags overnemen

Resources nemen niet de tags over die u toepast op een resourcegroep of een abonnement. Zie Azure Policies - tags om tags van een abonnement of resourcegroep toe te passen op de resources.

Tags en facturering

U kunt tags gebruiken om uw factureringsgegevens te groeperen. Als u bijvoorbeeld meerdere VM's voor verschillende organisaties uitvoert, gebruikt u de tags om het gebruik te groeperen op kostenplaats. U kunt ook tags gebruiken om de kosten te categoriseren op basis van de runtimeomgeving, zoals de facturering van het gebruik voor VM's die worden uitgevoerd in de productieomgeving.

U kunt informatie over tags ophalen door het gebruiksbestand te downloaden dat beschikbaar is in Azure Portal. Voor meer informatie raadpleegt u Uw Azure-factuur en de dagelijkse gebruiksgegevens downloaden of bekijken. Voor services die ondersteuning bieden voor tags met facturering, worden de tags weergegeven in de kolom Tags.

Zie Naslaginformatie over REST API voor Azure Billing voor REST API-bewerkingen.

Beperkingen

Voor tags gelden de volgende beperkingen:

Niet alle resourcetypen ondersteunen tags. Zie Tagondersteuning voor Azure-resources om te bepalen of u een tag kunt toepassen op een resourcetype.
Elke resource, resourcegroep en abonnement mag maximaal vijftig combinaties van tagnaam en -waarde hebben. Als u meer tags wilt toepassen dan het maximaal toegestane aantal, gebruikt u een JSON-tekenreeks voor de tagwaarde. De JSON-tekenreeks kan veel van de waarden bevatten die u op één tagnaam toepast. Een resourcegroep of abonnement kan veel bronnen bevatten die elk vijftig combinaties van tagnaam en -waarde bevatten.
De tagnaam heeft een limiet van 512 tekens en de tagwaarde heeft een limiet van 256 tekens. Voor opslagaccounts heeft de tagnaam een limiet van 128 tekens en de tagwaarde een limiet van 256 tekens.
Klassieke resources, zoals Cloud Services bieden geen ondersteuning voor tags.
Azure IP-groepen en Azure Firewall-beleid bieden geen ondersteuning voor PATCH-bewerkingen. Met bewerkingen met de PATCH API-methode kunnen dus geen tags via de portal worden bijgewerkt. In plaats daarvan kunt u de UPDATE-opdrachten voor deze resources gebruiken. U kunt tags voor een IP-groep bijwerken, bijvoorbeeld met de opdracht az network ip-group update .
Tagnamen mogen deze tekens niet bevatten: <, >, , %, &\, , , ?/
Notitie
- Dns-zones (Azure Domain Name System) bieden geen ondersteuning voor het gebruik van spaties in de tag of een tag die begint met een getal. Azure DNS-tagnamen bieden geen ondersteuning voor speciale en Unicode-tekens. De waarde kan alle tekens bevatten.
- Traffic Manager biedt geen ondersteuning voor het gebruik van spaties # of : in de tagnaam. De tagnaam mag niet met een getal beginnen.
- Azure Front Door biedt geen ondersteuning voor het gebruik van # of : in de tagnaam.
- De volgende Azure-resources ondersteunen slechts vijftien tags:
  - Azure Automation
  - Azure Content Delivery Network (CDN)
  - Azure DNS (zone- en A-records)
  - Opgeslagen zoekopdracht in Azure Log Analytics

Volgende stappen

Niet alle resourcetypen ondersteunen tags. Zie Tagondersteuning voor Azure-resources om te bepalen of u een tag kunt toepassen op een resourcetype.
Zie Resource naming and tagging decision guide (Handleiding voor het nemen van namen en taggen van resources) voor aanbevelingen over het implementeren van een tagstrategie.

Tags gebruiken om uw Azure-resources en beheerhiërarchie te organiseren

Vereiste toegang

PowerShell

Tags toepassen

Lijst op label

Tags verwijderen

Azure CLI

Tags toepassen

Lijst per tag weergeven

Tags verwijderen

Afhandeling van ruimten

ARM-sjablonen

Waarden toepassen

Een object toepassen

Een JSON-tekenreeks toepassen

Tags toepassen vanuit resourcegroep

Tags toepassen op resourcegroepen of abonnementen

Portal

REST-API

SDK's

Tags overnemen

Tags en facturering

Beperkingen

Volgende stappen

Aanvullende resources

Aanvullende resources

Tags gebruiken om uw Azure-resources en beheerhiërarchie te organiseren

Vereiste toegang

PowerShell

Tags toepassen

Tags weergeven

Lijst op label

Tags verwijderen

Azure CLI

Tags toepassen

Tags weergeven

Lijst per tag weergeven

Tags verwijderen

Afhandeling van ruimten

ARM-sjablonen

Waarden toepassen

Een object toepassen

Een JSON-tekenreeks toepassen

Tags toepassen vanuit resourcegroep

Tags toepassen op resourcegroepen of abonnementen

Portal

REST-API

SDK's

Tags overnemen

Tags en facturering

Beperkingen

Volgende stappen

Aanvullende resources

Aanvullende resources