Utiliser des étiquettes pour organiser vos ressources Azure et votre hiérarchie de gestionUse tags to organize your Azure resources and management hierarchy

Vous allez appliquer des étiquettes à vos ressources Azure, groupes de ressources et abonnements pour les organiser de façon logique dans une taxonomie.You apply tags to your Azure resources, resource groups, and subscriptions 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.

Pour obtenir des recommandations sur la façon d’implémenter une stratégie d’étiquetage, consultez Guides de décision concernant le nommage et l’étiquetage des ressources.For recommendations on how to implement a tagging strategy, see Resource naming and tagging decision guide.

Important

Les noms des étiquettes ne respectent pas la casse pour les opérations.Tag names are case-insensitive for operations. Une étiquette portant un nom, quelle que soit la casse, est mise à jour ou récupérée.A tag with a tag name, regardless of casing, is updated or retrieved. Toutefois, il est possible que le fournisseur de ressources conserve la casse indiquée pour le nom de l’étiquette.However, the resource provider might keep the casing you provide for the tag name. Vous verrez cette casse dans les rapports sur les coûts.You'll see that casing in cost reports.

Les valeurs des étiquettes respectent la casse.Tag values are case-sensitive.

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.

Accès requisRequired access

Pour appliquer des étiquettes à une ressource, vous devez disposer d’un accès en écriture au type de ressource Microsoft.Resources/tags.To apply tags to a resource, you must have write access to the Microsoft.Resources/tags resource type. Le rôle Contributeur d’étiquette vous permet d’appliquer des étiquettes à une entité sans avoir accès à l’entité elle-même.The Tag Contributor role lets you apply tags to an entity without having access to the entity itself. Actuellement, le rôle Contributeur d’étiquette ne peut pas appliquer d’étiquettes aux ressources ou groupes de ressources via le portail.Currently, the tag contributor role can't apply tags to resources or resource groups through the portal. Il peut appliquer des étiquettes aux abonnements via le portail.It can apply tags to subscriptions through the portal. Il prend en charge toutes les opérations d’étiquettes via PowerShell et l’API REST.It supports all tag operations through PowerShell and REST API.

Le rôle Contributeur accorde également l’accès requis pour appliquer des étiquettes à n’importe quelle entité.The Contributor role also grants the required access to apply tags to any entity. 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.

PowerShellPowerShell

Appliquer des étiquettesApply tags

Azure PowerShell propose deux commandes pour appliquer des étiquettes : New-AzTag et Update-AzTag.Azure PowerShell offers two commands for applying tags - New-AzTag and Update-AzTag. Vous devez disposer du module Az.Resources 1.12.0 ou version ultérieure.You must have the Az.Resources module 1.12.0 or later. Vous pouvez vérifier votre version avec Get-Module Az.Resources.You can check your version with Get-Module Az.Resources. Vous pouvez installer ce module ou installer Azure PowerShell 3.6.1 ou version ultérieure.You can install that module or install Azure PowerShell 3.6.1 or later.

New-AzTag remplace toutes les étiquettes de la ressource, du groupe de ressources ou de l’abonnement.The New-AzTag replaces all tags on the resource, resource group, or subscription. Lors de l’appel de la commande, transmettez l’ID de ressource de l’entité que vous souhaitez étiquetter.When calling the command, pass in the resource ID of the entity you wish to tag.

L’exemple suivant applique un ensemble d’étiquettes à un compte de stockage :The following example applies a set of tags to a storage account:

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

Une fois la commande terminée, notez que la ressource a deux étiquettes.When the command completes, notice that the resource has two tags.

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

Si vous réexécutez la commande, mais cette fois avec des étiquettes différentes, vous remarquerez que les étiquettes précédentes sont supprimées.If you run the command again but this time with different tags, notice that the earlier tags are removed.

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

Pour ajouter des étiquettes à une ressource qui a déjà des étiquettes, utilisez Update-AzTag.To add tags to a resource that already has tags, use Update-AzTag. Définissez le paramètre -Operation sur Fusion.Set the -Operation parameter to Merge.

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

Notez que les deux nouvelles étiquettes ont été ajoutées aux deux étiquettes existantes.Notice that the two new tags were added to the two existing tags.

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

Chaque nom d’étiquette ne peut avoir qu’une seule valeur.Each tag name can have only one value. Si vous fournissez une nouvelle valeur pour une étiquette, l’ancienne valeur est remplacée même si vous utilisez l’opération de fusion.If you provide a new value for a tag, the old value is replaced even if you use the merge operation. L’exemple suivant modifie l’étiquette d’état normal en vert.The following example changes the Status tag from Normal to Green.

$tags = @{"Status"="Green"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge
Properties :
        Name         Value
        ===========  ==========
        Status       Green
        Dept         Finance
        Team         Compliance
        Environment  Production

Lorsque vous définissez le paramètre -Operation sur Remplacer, les étiquettes existantes sont remplacées par le nouvel ensemble d’étiquettes.When you set the -Operation parameter to Replace, the existing tags are replaced by the new set of tags.

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

Seules les nouvelles étiquettes restent sur la ressource.Only the new tags remain on the resource.

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

Les mêmes commandes fonctionnent également avec les groupes de ressources ou les abonnements.The same commands also work with resource groups or subscriptions. Vous transmettez l’identificateur pour le groupe de ressources ou l’abonnement que vous souhaitez baliser.You pass in the identifier for the resource group or subscription you want to tag.

Pour ajouter un nouvel ensemble d’étiquettes à un groupe de ressources, utilisez :To add a new set of tags to a resource group, use:

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

Pour mettre à jour les étiquettes d’un groupe de ressources, utilisez :To update the tags for a resource group, use:

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

Pour ajouter un nouvel ensemble d’étiquettes à un abonnement, utilisez :To add a new set of tags to a subscription, use:

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

Pour mettre à jour les étiquettes d’un abonnement, utilisez :To update the tags for a subscription, use:

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

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 { Update-AzTag -Tag @{ "Dept"="IT"; "Environment"="Test" } -ResourceId $_.ResourceId -Operation Merge }

Répertorier les balisesList tags

Pour obtenir les étiquettes d’une ressource, d’un groupe de ressources ou d’un abonnement, utilisez la commande Get-AzTag et transmettez l’ID de ressource de l’entité.To get the tags for a resource, resource group, or subscription, use the Get-AzTag command and pass in the resource ID for the entity.

Pour afficher les étiquettes d’une ressource, utilisez :To see the tags for a resource, use:

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

Pour voir les étiquettes d’un groupe de ressources, utilisez :To see the tags for a resource group, use:

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

Pour afficher les étiquettes d’un abonnement, utilisez :To see the tags for a subscription, use:

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

Liste par étiquetteList by tag

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 @{ "CostCenter"="00123"}).Name

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

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

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 @{ "CostCenter"="00123" }).ResourceGroupName

Supprimer des étiquettesRemove tags

Pour supprimer des étiquette spécifiques, utilisez Update-AzTag et définissez -Operation sur supprimer.To remove specific tags, use Update-AzTag and set -Operation to Delete. Transmettez les étiquettes que vous souhaitez supprimer.Pass in the tags you want to delete.

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

Les étiquettes spécifiées sont supprimées.The specified tags are removed.

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

Pour supprimer toutes les étiquettes, utilisez la commande Remove-AzTag.To remove all tags, use the Remove-AzTag command.

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

Azure CLIAzure CLI

Appliquer des étiquettesApply tags

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

Actuellement, Azure CLI n’a pas de commande pour l’application d’étiquettes aux abonnements.Currently, Azure CLI doesn't have a command for applying tags to subscriptions. Toutefois, vous pouvez utiliser l’interface CLI pour déployer un modèle ARM qui applique les étiquettes à un abonnement.However, you can use CLI to deploy an ARM template that applies the tags to a subscription. Voir Appliquer des étiquettes à des groupes de ressources ou à des abonnements.See Apply tags to resource groups or subscriptions.

Répertorier les balisesList tags

Pour afficher les étiquettes existantes d'une ressource, utilisez :To see the existing tags for a resource, use:

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

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

Liste par étiquetteList by tag

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

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

Gestion des espacesHandling spaces

Si les noms ou valeurs de vos étiquettes incluent des espaces, vous devez accomplir quelques étapes supplémentaires.If your tag names or values include spaces, you must take a couple extra steps.

Les paramètres --tags dans Azure CLI peuvent accepter une chaîne constituée d’un tableau de chaînes.The --tags parameters in the Azure CLI can accept a string that consists of an array of strings. L’exemple suivant remplace les étiquettes d’un groupe de ressources où les étiquettes contiennent des espaces et des traits d’union :The following example overwrites the tags in a resource group where the tags have spaces and hyphen:

TAGS=("Cost Center=Finance-1222" "Location=West US")
az group update --name examplegroup --tags "${TAGS[@]}"

Vous pouvez utiliser la même syntaxe lors de la création ou de la mise à jour d’un groupe de ressources ou de ressources à l’aide du paramètre --tags .You can use the same syntax when you create or update a resource group or resources by using the --tags parameter.

Pour mettre à jour les étiquettes à l’aide du paramètre --set, vous devez passer la clé et la valeur en tant que chaîne.To update the tags by using the --set parameter, you must pass the key and value as a string. L’exemple suivant ajoute une étiquette unique à un groupe de ressources :The following example appends a single tag to a resource group:

TAG="Cost Center='Account-56'"
az group update --name examplegroup --set tags."$TAG"

Dans ce cas, la valeur de l’étiquette est marquée avec des apostrophes car elle comporte un trait d’union.In the this case, the tag value is marked with single quotes because the value has a hyphen.

Il se peut que vous deviez également appliquer des étiquettes à de nombreuses ressources.You might also need to apply tags to many resources. L’exemple suivant applique toutes les étiquettes d’un groupe de ressources à ses ressources quand les étiquettes pourraient contenir des espaces :The following example applies all tags from a resource group to its resources when the tags might 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

Vous pouvez baliser les ressources, les groupes de ressources et les abonnements pendant le déploiement avec un modèle Resource Manager.You can tag resources, resource groups, and subscriptions during deployment with a Resource Manager template.

Appliquer les valeursApply values

L’exemple suivant déploie un compte de stockage avec trois étiquettes.The following example deploys a storage account with three tags. Deux des étiquettes (Dept et Environment) sont définies sur des valeurs littérales.Two of the tags (Dept and Environment) are set to literal values. Une étiquette (LastDeployed) a pour valeur un paramètre dont la valeur par défaut est la date actuelle.One tag (LastDeployed) is set to a parameter that defaults to the current date.

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

Appliquer un objetApply an object

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. Cette approche offre plus de souplesse que l’exemple précédent, car l’objet peut avoir des propriétés différentes.This approach provides more flexibility than the previous example because the object can have different properties. 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": {}
        }
    ]
}

Analyser une chaîne JSONApply a JSON string

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": {}
        }
    ]
}

Appliquer des étiquettes à des groupes de ressources ou à des abonnementsApply tags to resource groups or subscriptions

Vous pouvez ajouter des étiquettes à un groupe de ressources ou à un abonnement en déployant le type de ressource Microsoft.Resources/tags.You can add tags to a resource group or subscription by deploying the Microsoft.Resources/tags resource type. Les étiquettes sont appliquées au groupe de ressources cible ou à l’abonnement pour le déploiement.The tags are applied to the target resource group or subscription for the deployment. Chaque fois que vous déployez le modèle, vous remplacez les étiquettes précédemment appliquées.Each time you deploy the template you replace any tags there were previously applied.

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

Pour appliquer les étiquettes à un groupe de ressources, utilisez PowerShell ou Azure CLI.To apply the tags to a resource group, use either PowerShell or Azure CLI. Déployez sur le groupe de ressources que vous souhaitez baliser.Deploy to the resource group that you want to tag.

New-AzResourceGroupDeployment -ResourceGroupName exampleGroup -TemplateFile https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json
az deployment group create --resource-group exampleGroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

Pour appliquer les étiquettes à un abonnement, utilisez PowerShell ou Azure CLI.To apply the tags to a subscription, use either PowerShell or Azure CLI. Déployez sur l’abonnement que vous souhaitez baliser.Deploy to the subscription that you want to tag.

New-AzSubscriptionDeployment -name tagresourcegroup -Location westus2 -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json
az deployment sub create --name tagresourcegroup --location westus2 --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

Pour plus d’informations sur les déploiements dans des abonnements, consultez Créer des groupes de ressources et des ressources au niveau de l’abonnement.For more information about subscription deployments, see Create resource groups and resources at the subscription level.

Le modèle suivant ajoute les étiquettes depuis un objet vers un groupe de ressources ou un abonnement.The following template adds the tags from an object to either a resource group or subscription.

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

PortailPortal

Si un utilisateur ne dispose pas de l’accès requis pour appliquer des étiquettes, vous pouvez lui attribuer le rôle Contributeur d’étiquette.If a user doesn't have the required access for applying tags, you can assign the Tag Contributor role to the user. Pour plus d’informations, consultez Didacticiel : Accorder un accès utilisateur aux ressources Azure à l’aide du contrôle RBAC et du portail Azure.For more information, see Tutorial: Grant a user access to Azure resources using RBAC and the Azure portal.

  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.

    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. Ensuite, sélectionnez Attribuer des étiquettes.Then, select Assign tags.

    Sélectionner plusieurs ressources

  2. Ajoutez des noms et des valeurs.Add names and values. Lorsque vous avez terminé, sélectionnez Enregistrer.When done, select Save.

    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, recherchez étiquettes.On the Azure portal menu, search for tags. Sélectionnez-le parmi les options disponibles.Select it from the available options.

    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

Pour travailler avec des étiquettes par le biais de l’API REST Azure, utilisez :To work with tags through the Azure REST API, use:

Hériter des étiquettesInherit tags

Les balises appliquées au groupe de ressources ou à l’abonnement ne sont pas héritées par les ressources.Tags applied to the resource group or subscription aren't inherited by the resources. Pour appliquer des balises d’un abonnement ou d’un groupe de ressources aux ressources, consultez Stratégies Azure - Étiquettes.To apply tags from a subscription or resource group to the resources, see Azure Policies - tags.

É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 Rate Card APIs or the usage comma-separated values (CSV) file. Vous téléchargez le fichier d’utilisation à partir du portail Azure.You download the usage file from the 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.

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, groupe de ressources et abonnement peuvent inclure un maximum de 50 paires nom/valeur d’étiquette.Each resource, resource group, and subscription 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 ou un abonnement peut contenir de nombreuses ressources qui ont chacune 50 paires nom/valeur d’étiquette.A resource group or subscription 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 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 Manager services also don't allow the use of spaces in the tag.

    Azure Front Door ne prend pas en charge l’utilisation de # dans le nom de la balise.Azure Front Door doesn't support the use of # in the tag name.

    Azure Automation et Azure CDN ne gèrent que 15 balises sur les ressources.Azure Automation and Azure CDN only support 15 tags on resources.

Étapes suivantesNext steps