Organisation des ressources Azure à l'aide d'étiquettesUse tags to organize your Azure resources

Vous allez appliquer des balises à vos ressources Azure pour les organiser de façon logique dans une taxonomie.You apply tags to your Azure resources to logically organize them into a taxonomy. Chaque balise se compose d’une paire nom-valeur.Each tag consists of a name and a value pair. Par exemple, vous pouvez appliquer le nom « Environnement » et la valeur « Production » à toutes les ressources en production.For example, you can apply the name "Environment" and the value "Production" to all the resources in production.

Une fois que vous avez appliqué une balise, vous pouvez utiliser son nom et sa valeur pour récupérer toutes les ressources dans votre abonnement.After you apply tags, you can retrieve all the resources in your subscription with that tag name and value. Les balises vous permettent de récupérer les ressources associées de groupes de ressources différents.Tags enable you to retrieve related resources from different resource groups. Cette approche est utile lorsque vous devez organiser les ressources à des fins de facturation ou de gestion.This approach is helpful when you need to organize resources for billing or management.

Votre taxonomie doit prendre en compte une stratégie de balisage des métadonnées en libre-service en plus d’une stratégie de balisage automatique pour réduire la charge pesant sur les utilisateurs et augmenter la précision.Your taxonomy should consider a self-service metadata tagging strategy in addition to an autotagging strategy to reduce the burden on users and increase accuracy.

Notes

Cet article explique comment supprimer les données personnelles de l’appareil ou du service et il peut être utilisé dans le cadre de vos obligations en vertu du Règlement général sur la protection des données.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. Si vous recherchez des informations générales sur le RGPD, consultez la section RGPD du portail Service Trust.If you’re looking for general info about GDPR, see the GDPR section of the Service Trust portal.

LimitesLimitations

Les limites suivantes s’appliquent aux balises :The following limitations apply to tags:

  • Les types de ressources ne prennent pas tous en charge les étiquettes.Not all resource types support tags. Pour déterminer si vous pouvez appliquer une étiquette à un type de ressource, consultez Prise en charge des étiquettes pour les ressources Azure.To determine if you can apply a tag to a resource type, see Tag support for Azure resources.

  • Chaque ressource ou groupe de ressources peut inclure un maximum de 50 paires nom/valeur de balise.Each resource or resource group can have a maximum of 50 tag name/value pairs. Si vous devez appliquer plus de balises que le nombre maximal autorisé, utilisez une chaîne JSON comme valeur de balise.If you need to apply more tags than the maximum allowed number, use a JSON string for the tag value. La chaîne JSON peut contenir plusieurs valeurs appliquées à un seul nom de balise.The JSON string can contain many values that are applied to a single tag name. Un groupe de ressources peut contenir de nombreuses ressources qui ont chacune 50 paires nom/valeur de balise.A resource group can contain many resources that each have 50 tag name/value pairs.

  • Le nom de balise est limité à 512 caractères, et la valeur de balise à 256 caractères.The tag name is limited to 512 characters, and the tag value is limited to 256 characters. Pour les comptes de stockage, le nom de balise est limité à 128 caractères, et la valeur de balise à 256 caractères.For storage accounts, the tag name is limited to 128 characters, and the tag value is limited to 256 characters.

  • Les machines virtuelles généralisées ne prennent pas en charge les balises.Generalized VMs don't support tags.

  • Les ressources d’un groupe de ressources n’héritent pas des balises appliquées à ce groupe de ressources.Tags applied to the resource group are not inherited by the resources in that resource group.

  • Les balises ne peuvent pas être appliquées à des ressources classiques comme les Services cloud.Tags can't be applied to classic resources such as Cloud Services.

  • Les noms de balise ne peuvent pas contenir ces caractères : <, >, %, &, \, ?, /Tag names can't contain these characters: <, >, %, &, \, ?, /

    Notes

    Actuellement les zones Azure DNS et les services Traffic Manager n’autorisent pas non plus l’utilisation des espaces dans la balise.Currently Azure DNS zones and Traffic Manger services also don't allow the use of spaces in the tag.

Accès requisRequired access

Pour appliquer des étiquettes à des ressources, l'utilisateur doit disposer de l'accès en écriture pour ce type de ressource.To apply tags to resources, the user must have write access to that resource type. Pour appliquer des étiquettes à tous les types de ressources, utilisez le rôle Contributeur.To apply tags to all resource types, use the Contributor role. Pour appliquer des étiquettes à un seul type de ressource, utilisez le rôle Contributeur correspondant à cette ressource.To apply tags to only one resource type, use the contributor role for that resource. Par exemple, pour appliquer des étiquettes aux machines virtuelles, utilisez le rôle Contributeur de machines virtuelles.For example, to apply tags to virtual machines, use the Virtual Machine Contributor.

StratégiesPolicies

Vous pouvez utiliser Azure Policy pour appliquer des règles et des conventions d'étiquetage.You can use Azure Policy to enforce tagging rules and conventions. En créant une stratégie, vous éviterez que des ressources non conformes aux étiquettes attendues par votre organisation soient déployées dans le cadre de votre abonnement.By creating a policy, you avoid the scenario of resources being deployed to your subscription that don't comply with the expected tags for your organization. Au lieu d'appliquer des étiquettes ou de rechercher des ressources non conformes manuellement, vous pouvez créer une stratégie qui appliquera automatiquement les étiquettes nécessaires pendant le déploiement.Instead of manually applying tags or searching for resources that aren't compliant, you can create a policy that automatically applies the needed tags during deployment. Les étiquettes peuvent également être appliquées aux ressources existantes avec le nouvel effet Modifier et une tâche de correction.Tags can also now be applied to existing resources with the new Modify effect and a remediation task. La section suivante présente des exemples de stratégies pour les étiquettes.The following section shows example policies for tags.

NameName DescriptionDescription Effet(s)Effect(s) VersionVersion
Ajouter une étiquette aux groupes de ressourcesAdd a tag to resource groups Ajoute l’étiquette et la valeur indiquées lors de la création ou de la mise à jour d’un groupe de ressources auquel cette étiquette manque.Adds the specified tag and value when any resource group missing this tag is created or updated. Il est possible de corriger des groupes de ressources existants en déclenchant une tâche de correction.Existing resource groups can be remediated by triggering a remediation task. Si l’étiquette existe avec une valeur différente, elle n’est pas modifiée.If the tag exists with a different value it will not be changed. modifymodify 1.0.01.0.0
Ajouter une étiquette aux ressourcesAdd a tag to resources Ajoute l’étiquette et la valeur indiquées lors de la création ou de la mise à jour d’une ressource à laquelle cette étiquette manque.Adds the specified tag and value when any resource missing this tag is created or updated. Il est possible de corriger des ressources existantes en déclenchant une tâche de correction.Existing resources can be remediated by triggering a remediation task. Si l’étiquette existe avec une valeur différente, elle n’est pas modifiée.If the tag exists with a different value it will not be changed. Ne modifie pas les étiquettes sur les groupes de ressources.Does not modify tags on resource groups. modifymodify 1.0.01.0.0
Ajouter ou remplacer une étiquette sur des groupes de ressourcesAdd or replace a tag on resource groups Ajoute ou remplace l’étiquette et la valeur indiquées lors de la création ou de la mise à jour d’un groupe de ressources.Adds or replaces the specified tag and value when any resource group is created or updated. Il est possible de corriger des groupes de ressources existants en déclenchant une tâche de correction.Existing resource groups can be remediated by triggering a remediation task. modifymodify 1.0.01.0.0
Ajouter ou remplacer une étiquette dans les ressourcesAdd or replace a tag on resources Ajoute ou remplace l’étiquette et la valeur indiquées lors de la création ou de la mise à jour d’une ressource.Adds or replaces the specified tag and value when any resource is created or updated. Il est possible de corriger des ressources existantes en déclenchant une tâche de correction.Existing resources can be remediated by triggering a remediation task. Ne modifie pas les étiquettes sur les groupes de ressources.Does not modify tags on resource groups. modifymodify 1.0.01.0.0
Ajouter l’étiquette et sa valeur par défautAppend tag and its default value Ajoute l’étiquette et la valeur indiquées lors de la création ou de la mise à jour d’une ressource à laquelle cette étiquette manque.Appends the specified tag and value when any resource which is missing this tag is created or updated. Ne modifie pas les étiquettes des ressources créées avant l’application de cette stratégie, tant que ces ressources ne sont pas modifiées.Does not modify the tags of resources created before this policy was applied until those resources are changed. Ne s’applique pas aux groupes de ressources.Does not apply to resource groups. De nouvelles stratégies d’effet « modify » sont disponibles pour prendre en charge la correction des étiquettes sur les ressources existantes (voir https://aka.ms/modifydoc).New 'modify' effect policies are available that support remediation of tags on existing resources (see https://aka.ms/modifydoc). appendappend 1.0.01.0.0
Ajouter l’étiquette et sa valeur par défaut aux groupes de ressourcesAppend tag and its default value to resource groups Ajoute l’étiquette et la valeur indiquées lors de la création ou de la mise à jour d’un groupe ressource auquel cette étiquette manque.Appends the specified tag and value when any resource group which is missing this tag is created or updated. Ne modifie pas les étiquettes des groupes de ressources créés avant l’application de cette stratégie, tant que ces groupes de ressources ne sont pas modifiés.Does not modify the tags of resource groups created before this policy was applied until those resource groups are changed. De nouvelles stratégies d’effet « modify » sont disponibles pour prendre en charge la correction des étiquettes sur les ressources existantes (voir https://aka.ms/modifydoc).New 'modify' effect policies are available that support remediation of tags on existing resources (see https://aka.ms/modifydoc). appendappend 1.0.01.0.0
Ajouter l’étiquette avec sa valeur du groupe de ressourcesAppend tag and its value from the resource group Ajoute l’étiquette indiquée avec sa valeur du groupe de ressources lors de la création ou de la mise à jour d’une ressource à laquelle cette étiquette manque.Appends the specified tag with its value from the resource group when any resource which is missing this tag is created or updated. Ne modifie pas les étiquettes des ressources créées avant l’application de cette stratégie, tant que ces ressources ne sont pas modifiées.Does not modify the tags of resources created before this policy was applied until those resources are changed. De nouvelles stratégies d’effet « modify » sont disponibles pour prendre en charge la correction des étiquettes sur les ressources existantes (voir https://aka.ms/modifydoc).New 'modify' effect policies are available that support remediation of tags on existing resources (see https://aka.ms/modifydoc). appendappend 1.0.01.0.0
Hériter d’une étiquette du groupe de ressourcesInherit a tag from the resource group Ajoute ou remplace l’étiquette et la valeur indiquées du groupe de ressources parent lors de la création ou de la mise à jour d’une ressource.Adds or replaces the specified tag and value from the parent resource group when any resource is created or updated. Il est possible de corriger des ressources existantes en déclenchant une tâche de correction.Existing resources can be remediated by triggering a remediation task. modifymodify 1.0.01.0.0
Hériter d’une étiquette du groupe de ressources en cas d’absenceInherit a tag from the resource group if missing Ajoute l’étiquette indiquée avec sa valeur du groupe de ressources parent lors de la création ou de la mise à jour d’une ressource à laquelle cette étiquette manque.Adds the specified tag with its value from the parent resource group when any resource missing this tag is created or updated. Il est possible de corriger des ressources existantes en déclenchant une tâche de correction.Existing resources can be remediated by triggering a remediation task. Si l’étiquette existe avec une valeur différente, elle n’est pas modifiée.If the tag exists with a different value it will not be changed. modifymodify 1.0.01.0.0
Exiger l’étiquette spécifiéeRequire specified tag Applique l’existence d’une étiquette.Enforces existence of a tag. Ne s’applique pas aux groupes de ressources.Does not apply to resource groups. denydeny 1.0.01.0.0
Exiger l’étiquette spécifiée sur des groupes de ressourcesRequire specified tag on resource groups Applique l’existence d’une étiquette sur des groupes de ressources.Enforces existence of a tag on resource groups. denydeny 1.0.01.0.0
Exiger une étiquette et sa valeurRequire tag and its value Applique une étiquette requise et sa valeur.Enforces a required tag and its value. Ne s’applique pas aux groupes de ressources.Does not apply to resource groups. denydeny 1.0.01.0.0
Exiger une étiquette et sa valeur sur des groupes de ressourcesRequire tag and its value on resource groups Applique une étiquette obligatoire avec sa valeur aux groupes de ressources.Enforces a required tag and its value on resource groups. denydeny 1.0.01.0.0

PowerShellPowerShell

Pour afficher les étiquettes existantes d'un groupe de ressources, utilisez :To see the existing tags for a resource group, use:

(Get-AzResourceGroup -Name examplegroup).Tags

Le script retourne les informations au format suivant :That script returns the following format:

Name                           Value
----                           -----
Dept                           IT
Environment                    Test

Pour afficher les étiquettes existantes d’une ressource dont le nom et le groupe de ressources sont spécifiés, utilisez :To see the existing tags for a resource that has a specified name and resource group, use:

(Get-AzResource -ResourceName examplevnet -ResourceGroupName examplegroup).Tags

Ou, si vous avez l’ID d’une ressource, vous pouvez transmettre cet ID de ressource pour obtenir les étiquettes.Or, if you have the resource ID for a resource, you can pass that resource ID to get the tags.

(Get-AzResource -ResourceId /subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Storage/storageAccounts/<storage-name>).Tags

Pour obtenir des groupes de ressources qui ont un nom et une valeur d’étiquette spécifiques, utilisez :To get resource groups that have a specific tag name and value, use:

(Get-AzResourceGroup -Tag @{ "Dept"="Finance" }).ResourceGroupName

Pour obtenir des ressources qui ont un nom et une valeur d’étiquette spécifiques, utilisez :To get resources that have a specific tag name and value, use:

(Get-AzResource -Tag @{ "Dept"="Finance"}).Name

Pour obtenir les ressources contenant un nom d'étiquette spécifique, utilisez :To get resources that have a specific tag name, use:

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

Chaque fois que vous appliquez des étiquettes à une ressource ou à un groupe de ressources, vous remplacez les étiquettes existantes de cette ressource ou de ce groupe de ressources.Every time you apply tags to a resource or a resource group, you overwrite the existing tags on that resource or resource group. Par conséquent, vous devez utiliser une approche différente selon que la ressource ou le groupe de ressources comporte ou non des étiquettes existantes.Therefore, you must use a different approach based on whether the resource or resource group has existing tags.

Pour ajouter des étiquettes à un groupe de ressources sans étiquettes existantes, utilisez :To add tags to a resource group without existing tags, use:

Set-AzResourceGroup -Name examplegroup -Tag @{ "Dept"="IT"; "Environment"="Test" }

Pour ajouter des étiquettes à un groupe de ressources avec des étiquettes existantes, récupérez les étiquettes existantes, ajoutez la nouvelle étiquette et réappliquez les étiquettes :To add tags to a resource group that has existing tags, retrieve the existing tags, add the new tag, and reapply the tags:

$tags = (Get-AzResourceGroup -Name examplegroup).Tags
$tags.Add("Status", "Approved")
Set-AzResourceGroup -Tag $tags -Name examplegroup

Pour ajouter des étiquettes à une ressource sans étiquettes existantes, utilisez :To add tags to a resource without existing tags, use:

$resource = Get-AzResource -ResourceName examplevnet -ResourceGroupName examplegroup
Set-AzResource -Tag @{ "Dept"="IT"; "Environment"="Test" } -ResourceId $resource.ResourceId -Force

Vous pouvez avoir plusieurs ressources portant le même nom dans un groupe de ressources.You may have more than one resource with the same name in a resource group. Dans ce cas, vous pouvez définir chaque ressource à l’aide des commandes suivantes :In that case, you can set each resource with the following commands:

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

Pour ajouter des étiquettes à une ressource avec des étiquettes existantes, utilisez :To add tags to a resource that has existing tags, use:

$resource = Get-AzResource -ResourceName examplevnet -ResourceGroupName examplegroup
$resource.Tags.Add("Status", "Approved")
Set-AzResource -Tag $resource.Tags -ResourceId $resource.ResourceId -Force

Pour appliquer toutes les étiquettes d’un groupe de ressources à ses ressources sans conserver les étiquettes existantes, utilisez le script suivant :To apply all tags from a resource group to its resources, and not keep existing tags on the resources, use the following script:

$group = Get-AzResourceGroup -Name examplegroup
Get-AzResource -ResourceGroupName $group.ResourceGroupName | ForEach-Object {Set-AzResource -ResourceId $_.ResourceId -Tag $group.Tags -Force }

Pour appliquer toutes les étiquettes d’un groupe de ressources à ses ressources et conserver les étiquettes existantes sur les ressources qui ne sont pas des doublons, utilisez le script suivant :To apply all tags from a resource group to its resources, and keep existing tags on resources that aren't duplicates, use the following script:

$group = Get-AzResourceGroup -Name examplegroup
if ($null -ne $group.Tags) {
    $resources = Get-AzResource -ResourceGroupName $group.ResourceGroupName
    foreach ($r in $resources)
    {
        $resourcetags = (Get-AzResource -ResourceId $r.ResourceId).Tags
        if ($resourcetags)
        {
            foreach ($key in $group.Tags.Keys)
            {
                if (-not($resourcetags.ContainsKey($key)))
                {
                    $resourcetags.Add($key, $group.Tags[$key])
                }
            }
            Set-AzResource -Tag $resourcetags -ResourceId $r.ResourceId -Force
        }
        else
        {
            Set-AzResource -Tag $group.Tags -ResourceId $r.ResourceId -Force
        }
    }
}

Pour supprimer toutes les étiquettes, utilisez une table de hachage vide :To remove all tags, pass an empty hash table:

Set-AzResourceGroup -Tag @{} -Name examplegroup

Azure CLIAzure CLI

Pour afficher les étiquettes existantes d'un groupe de ressources, utilisez :To see the existing tags for a resource group, use:

az group show -n examplegroup --query tags

Le script retourne les informations au format suivant :That script returns the following format:

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

Alternativement, pour afficher les étiquettes existantes d'une ressource dont le nom, le type et le groupe sont spécifiés, utilisez :Or, to see the existing tags for a resource that has a specified name, type, and resource group, use:

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

Durant un bouclage sur une collection de ressources, vous préférez peut-être afficher la ressource par ID de ressource.When looping through a collection of resources, you might want to show the resource by resource ID. Un exemple complet est présenté plus loin dans cet article.A complete example is shown later in this article. Pour afficher les étiquettes existantes d'une ressource dont l'ID de ressource est spécifié, utilisez :To see the existing tags for a resource that has a specified resource ID, use:

az resource show --id <resource-id> --query tags

Pour obtenir des groupes de ressources contenant une étiquette spécifique, utilisez az group list :To get resource groups that have a specific tag, use az group list:

az group list --tag Dept=IT

Pour obtenir toutes les ressources contenant une étiquette et une valeur spécifiques, utilisez az resource list :To get all the resources that have a particular tag and value, use az resource list:

az resource list --tag Dept=Finance

Lors de l’ajout d’étiquettes à un groupe de ressources ou à une ressource, vous pouvez remplacer les étiquettes existantes ou ajouter de nouvelles étiquettes à des étiquettes existantes.When adding tags to a resource group or resource, you can either overwrite the existing tags or append new tags to existing tags.

Pour remplacer les étiquettes existantes dans un groupe de ressources, utilisez :To overwrite the existing tags on a resource group, use:

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

Pour ajouter une étiquette aux étiquettes existantes dans un groupe de ressources, utilisez :To append a tag to the existing tags on a resource group, use:

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

Pour remplacer les étiquettes d’une ressource, utilisez :To overwrite the tags on a resource, use:

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

Pour ajouter une étiquette aux étiquettes existantes d’une ressource, utilisez :To append a tag to the existing tags on a resource, use:

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

Pour appliquer toutes les étiquettes d’un groupe de ressources à ses ressources sans conserver les étiquettes existantes, utilisez le script suivant :To apply all tags from a resource group to its resources, and not keep existing tags on the resources, use the following script:

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

Pour appliquer toutes les étiquettes d’un groupe de ressources à ses ressources et conserver les étiquettes existantes, utilisez le script suivant :To apply all tags from a resource group to its resources, and keep existing tags on resources, use the following script:

jsontags=$(az group show --name examplegroup --query tags -o json)
tags=$(echo $jsontags | tr -d '"{},' | sed 's/: /=/g')

resourceids=$(az resource list -g examplegroup --query [].id --output tsv)
for id in $resourceids
do
  resourcejsontags=$(az resource show --id $id --query tags -o json)
  resourcetags=$(echo $resourcejsontags | tr -d '"{},' | sed 's/: /=/g')
  az resource tag --tags $tags$resourcetags --id $id
done

Si les noms ou les valeurs de vos étiquettes incluent des espaces, vous devez effectuer quelques étapes supplémentaires.If your tag names or values include spaces, you must take a couple of extra steps. L’exemple suivant applique toutes les étiquettes d’un groupe de ressources à ses ressources quand les étiquettes peuvent contenir des espaces.The following example applies all tags from a resource group to its resources when the tags may contain spaces.

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

ModèlesTemplates

Pour marquer une ressource au cours du déploiement, ajoutez l’élément tags à la ressource que vous déployez.To tag a resource during deployment, add the tags element to the resource you're deploying. Indiquez le nom et la valeur de la balise.Provide the tag name and value.

Appliquer une valeur littérale au nom de baliseApply a literal value to the tag name

L’exemple suivant illustre un compte de stockage avec deux balises (Dept et Environment) définies sur des valeurs littérales :The following example shows a storage account with two tags (Dept and Environment) that are set to literal values:

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

Pour définir une balise sur une valeur datetime, utilisez la fonction utcNow.To set a tag to a datetime value, use the utcNow function.

Appliquer un objet à l’élément de baliseApply an object to the tag element

Vous pouvez définir un paramètre d’objet qui stocke plusieurs balises et appliquer cet objet à l’élément de balise.You can define an object parameter that stores several tags, and apply that object to the tag element. Chaque propriété de l’objet devient une balise distincte pour la ressource.Each property in the object becomes a separate tag for the resource. L’exemple suivant illustre un paramètre nommé tagValues appliqué à l’élément de balise.The following example has a parameter named tagValues that is applied to the tag element.

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

Appliquer une chaîne JSON au nom de baliseApply a JSON string to the tag name

Pour stocker plusieurs valeurs dans une seule balise, appliquez une chaîne JSON qui représente les valeurs.To store many values in a single tag, apply a JSON string that represents the values. La chaîne JSON complète est stockée sous la forme d’une balise ne pouvant pas dépasser 256 caractères.The entire JSON string is stored as one tag that can't exceed 256 characters. L’exemple illustre une balise unique nommée CostCenter qui contient plusieurs valeurs d’une chaîne JSON :The following example has a single tag named CostCenter that contains several values from a JSON string:

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

Appliquer des balises à partir d’un groupe de ressourcesApply tags from resource group

Pour appliquer des balises d’un groupe de ressources à une ressource, utilisez la fonction resourceGroup.To apply tags from a resource group to a resource, use the resourceGroup function. Lors de l’obtention de la valeur de balise, utilisez la syntaxe tags[tag-name] au lieu de la syntaxe tags.tag-name, car certains caractères ne sont pas correctement analysés dans la notation par points.When getting the tag value, use the tags[tag-name] syntax instead of the tags.tag-name syntax, because some characters aren't parsed correctly in the dot notation.

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

PortailPortal

  1. Pour afficher les balises d’une ressource ou d’un groupe de ressources, recherchez les balises existantes dans la vue d’ensemble.To view the tags for a resource or a resource group, look for existing tags in the overview. Si vous n’avez préalablement appliqué aucune balise, cette liste est vide.If you have not previously applied tags, the list is empty.

    Afficher les mots clés d’une ressource ou d’un groupe de ressources

  2. Pour ajouter un mot clé, sélectionnez Cliquez ici pour ajouter des mots clés.To add a tag, select Click here to add tags.

  3. Donnez un nom et une valeur.Provide a name and value. Sélectionnez + pour ajouter le mot clé.Select + to add the tag.

    Ajouter un mot clé

  4. Continuez à ajouter les mots clés dont vous avez besoin.Continue adding tags as needed. Lorsque vous avez terminé, sélectionnez Enregistrer.When done, select Save.

    Enregistrer les mots clés

  5. Les mots clés sont maintenant affichés dans la vue d’ensemble.The tags are now displayed in the overview.

    Afficher les mots clés

  6. Pour ajouter ou supprimer un mot clé, sélectionnez modifier.To add or delete a tag, select change.

  7. Pour supprimer un mot clé, sélectionnez l’icône de la Corbeille.To delete a tag, select the trash icon. Sélectionnez ensuite Enregistrer.Then, select Save.

    Supprimer un mot clé

Pour attribuer des balises en bloc à plusieurs ressources :To bulk assign tags to multiple resources:

  1. Dans une liste de ressources, cochez la case en regard des ressources auxquelles vous souhaitez attribuer le mot clé.From any list of resources, select the checkbox for the resources you want to assign the tag.

    Sélectionner plusieurs ressources

  2. Sélectionnez Attribuer des mots clés.Select Assign tags

    Attribuer des mots clés

  3. Après chaque nom et valeur, sélectionnez + .After each name and value, select +. Lorsque vous avez terminé, sélectionnez Attribuer.When done, select Assign.

    Sélectionner Attribuer

Pour afficher toutes les ressources ayant un mot clé :To view all resources with a tag:

  1. Dans le menu du portail Azure, sélectionnez Tous les services.On the Azure portal menu, select All services. Sélectionnez Générale, puis Balises.Select General, then Tags.

    Rechercher par mot clé

  2. Sélectionnez le mot clé pour afficher les ressources associées.Select the tag for viewing resources.

    Sélectionner le mot clé

  3. Toutes les ressources associées à ce mot clé sont affichées.All resources with that tag are displayed.

    Afficher les ressources par mot clé

API RESTREST API

Le portail Azure et PowerShell utilisent tous deux l’API REST de Resource Manager en arrière-plan.The Azure portal and PowerShell both use the Resource Manager REST API behind the scenes. Si vous avez besoin d'intégrer l'étiquetage dans un autre environnement, vous pouvez récupérer des étiquettes en utilisant GET sur l'ID de ressource et mettre à jour le jeu d'étiquettes en utilisant un appel PATCH.If you need to integrate tagging into another environment, you can get tags by using GET on the resource ID and update the set of tags by using a PATCH call.

Étiquettes et facturationTags and billing

Vous pouvez utiliser des étiquettes pour regrouper vos données de facturation.You can use tags to group your billing data. Par exemple, si vous exécutez plusieurs machines virtuelles pour différentes organisations, vous pouvez recourir aux étiquettes afin de regrouper l'utilisation par centre de coûts.For example, if you're running multiple VMs for different organizations, use the tags to group usage by cost center. Vous pouvez également utiliser des étiquettes pour catégoriser les coûts par environnement d'exécution ; par exemple, l'utilisation de la facturation pour les machines virtuelles en cours d'exécution dans l'environnement de production.You can also use tags to categorize costs by runtime environment, such as the billing usage for VMs running in the production environment.

Vous pouvez récupérer des informations sur les étiquettes par le biais des API Resource Usage et RateCard ou du fichier de valeurs séparées par des virgules (CSV).You can retrieve information about tags through the Azure Resource Usage and RateCard APIs or the usage comma-separated values (CSV) file. Téléchargez le fichier d’utilisation depuis le Centre des comptes Azure ou depuis le portail Azure.You download the usage file from the Azure Account Center or Azure portal. Pour plus d’informations, consultez Télécharger et consulter votre facture Azure et vos données d’utilisation quotidienne.For more information, see Download or view your Azure billing invoice and daily usage data. Lorsque vous téléchargez le fichier d’utilisation depuis le Centre des comptes Azure, sélectionnez Version 2.When downloading the usage file from the Azure Account Center, select Version 2. Pour les services qui prennent en charge les étiquettes avec la facturation, les étiquettes s'affichent dans la colonne Étiquettes.For services that support tags with billing, the tags appear in the Tags column.

Pour plus d’informations sur les opérations de l’API REST, consultez Informations de référence sur l’API REST Azure Billing.For REST API operations, see Azure Billing REST API Reference.

Étapes suivantesNext steps