Utiliser des étiquettes pour organiser vos ressources Azure et votre hiérarchie de gestion

Article
03/03/2023
18 minutes de lecture

Les étiquettes sont des éléments de métadonnées que vous appliquez à vos ressources Azure. Il s’agit de paires clé-valeur qui vous aident à identifier les ressources en fonction des paramètres pertinents pour votre organisation. Si vous souhaitez suivre l’environnement de déploiement de vos ressources, ajoutez une clé nommée Environnement. Pour identifier les ressources déployées en production, donnez-leur une valeur de production. Entièrement formé, la paire clé-valeur devient, Environnement = Production.

Vous pouvez appliquer des étiquettes à vos ressources Azure, groupes de ressources et abonnements pour les organiser.

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.

Les étiquettes de ressource prennent en charge tous les services engendrant des coûts. Pour vous assurer que les services engendrant des coûts sont approvisionnés à l’aide d’une étiquette, utilisez l’une des stratégies d’étiquette.

Avertissement

Les étiquettes sont stockées sous forme de texte brut. N’ajoutez jamais de valeurs sensibles aux étiquettes. Les valeurs sensibles peuvent être exposées par de nombreuses méthodes, y compris les rapports de coûts, les commandes qui retournent des définitions d’étiquette existantes, les historiques de déploiement, les modèles exportés et les journaux d’analyse.

Avertissement

Soyez prudent lorsque vous utilisez une langue autre que l’anglais dans vos étiquettes. Un échec de la progression du décodage peut en résulter lors du chargement des métadonnées de votre machine virtuelle à partir d’IMDS (Instance Metadata Service).

Important

Les noms des étiquettes ne respectent pas la casse pour les opérations. Une étiquette portant un nom, quelle que soit la casse, est mise à jour ou récupérée. Toutefois, il est possible que le fournisseur de ressources conserve la casse indiquée pour le nom de l’étiquette. Vous verrez cette casse dans les rapports sur les coûts.

Les valeurs des étiquettes respectent la casse.

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. Pour obtenir des informations générales concernant le Règlement général sur la protection des données (RGPD), consultez la section relative au RGPD du Centre de gestion de la confidentialité de Microsoft et la section relative au RGPD du Portail d’approbation de services.

Accès requis

Il existe deux façons d’obtenir l’accès requis aux ressources de balises.

Vous pouvez disposer d’un accès en écriture au type de ressource Microsoft.Resources/tags. Cet accès vous permet d’étiqueter n’importe quelle ressource, même si vous n’avez pas accès à la ressource elle-même. Le rôle Contributeur de balise accorde cet accès. Le rôle Contributeur d’étiquette, par exemple, ne peut pas appliquer d’étiquettes aux ressources ou groupes de ressources via le portail. Il peut cependant appliquer des étiquettes aux abonnements via le portail. Il prend en charge toutes les opérations d’étiquettes via Azure PowerShell et l’API REST.
Vous pouvez disposer d’un accès en écriture à la ressource elle-même. Le rôle Contributeur accorde l’accès requis pour appliquer des étiquettes à n’importe quelle entité. Pour appliquer des étiquettes à un seul type de ressource, utilisez le rôle Contributeur correspondant à cette ressource. Par exemple, pour appliquer des étiquettes aux machines virtuelles, utilisez le rôle Contributeur de machines virtuelles.

PowerShell

Appliquer des étiquettes

Azure PowerShell propose deux commandes pour appliquer des étiquettes : New-AzTag et Update-AzTag. Vous devez disposer de la Az.Resources version 1.12.0 du module ou ultérieure. Vous pouvez vérifier votre version avec Get-InstalledModule -Name Az.Resources. Vous pouvez installer ce module ou installer Azure PowerShell 3.6.1 ou version ultérieure.

New-AzTag remplace toutes les étiquettes de la ressource, du groupe de ressources ou de l’abonnement. Lorsque vous appelez la commande, transmettez l’ID de ressource de l’entité que vous souhaitez baliser.

L’exemple suivant applique un ensemble d’étiquettes à un compte de stockage :

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

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.

$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. Définissez le paramètre -Operation sur Merge.

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

Notez que les étiquettes existantes augmentent avec l’ajout des deux nouvelles étiquettes.

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

Chaque nom d’étiquette ne peut avoir qu’une seule valeur. 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. L’exemple suivant modifie l’étiquette d’état Status de normal en vert.

$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 Replace, les étiquettes existantes sont remplacées par le nouvel ensemble d’étiquettes.

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

Seules les nouvelles étiquettes restent sur la ressource.

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

Les mêmes commandes fonctionnent également avec les groupes de ressources ou les abonnements. Transmettez l’identificateur pour le groupe de ressources ou l’abonnement que vous souhaitez baliser.

Pour ajouter un nouvel ensemble d’étiquettes à un groupe de ressources, utilisez :

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

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

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

$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. Dans ce cas, vous pouvez définir chaque ressource à l’aide des commandes suivantes :

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

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

Pour afficher les étiquettes d’une ressource, utilisez :

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

Pour voir les étiquettes d’un groupe de ressources, utilisez :

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

Pour afficher les étiquettes d’un abonnement, utilisez :

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

Liste par étiquette

Pour obtenir des ressources qui ont un nom et une valeur d’étiquette spécifiques, utilisez :

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

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

Pour obtenir des groupes de ressources qui ont un nom et une valeur d’étiquette spécifiques, utilisez :

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

Supprimer des étiquettes

Pour supprimer des étiquette spécifiques, utilisez Update-AzTag et définissez -Operation sur Delete. Transmettez les ID de ressource des balises que vous souhaitez supprimer.

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

Les étiquettes spécifiées sont supprimées.

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

Pour supprimer toutes les étiquettes, utilisez la commande Remove-AzTag.

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

Azure CLI

Appliquer des étiquettes

Azure CLI propose deux commandes pour appliquer des étiquettes : az tag create et az tag update. Vous devez disposer de la version d’Azure CLI 2.10.0 ou ultérieure. Vous pouvez vérifier votre version avec az version. Pour la mise à jour ou l’installation, consultez Installer d’Azure CLI.

az tag create remplace toutes les étiquettes de la ressource, du groupe de ressources ou de l’abonnement. Lorsque vous appelez la commande, transmettez l’ID de ressource de l’entité que vous souhaitez baliser.

L’exemple suivant applique un ensemble d’étiquettes à un compte de stockage :

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

Une fois la commande terminée, notez que la ressource a deux étiquettes.

"properties": {
  "tags": {
    "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.

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

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

Pour ajouter des étiquettes à une ressource qui a déjà des étiquettes, utilisez az tag update. Définissez le paramètre --operation sur Merge.

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

Notez que les étiquettes existantes augmentent avec l’ajout des deux nouvelles étiquettes.

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

Chaque nom d’étiquette ne peut avoir qu’une seule valeur. Si vous fournissez une nouvelle valeur pour une étiquette, la nouvelle étiquette remplace l’ancienne valeur même si vous utilisez l’opération de fusion. L’exemple suivant modifie l’étiquette d’état Status de normal en vert.

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

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

Lorsque vous définissez le paramètre --operation sur Replace, les étiquettes existantes sont remplacées par le nouvel ensemble d’étiquettes.

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

Seules les nouvelles étiquettes restent sur la ressource.

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

Pour ajouter un nouvel ensemble d’étiquettes à un groupe de ressources, utilisez :

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

Pour mettre à jour les étiquettes d’un groupe de ressources, utilisez :

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

Pour ajouter un nouvel ensemble d’étiquettes à un abonnement, utilisez :

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

Pour mettre à jour les étiquettes d’un abonnement, utilisez :

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

Pour obtenir les étiquettes d’une ressource, d’un groupe de ressources ou d’un abonnement, utilisez la commande az tag list et transmettez l’ID de ressource de l’entité.

Pour afficher les étiquettes d’une ressource, utilisez :

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

Pour voir les étiquettes d’un groupe de ressources, utilisez :

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

Pour afficher les étiquettes d’un abonnement, utilisez :

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

Liste par étiquette

Pour obtenir des ressources qui ont un nom et une valeur d’étiquette spécifiques, utilisez :

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

Pour obtenir des ressources qui ont un nom et une valeur d’étiquette spécifiques avec une valeur d’étiquette, utilisez :

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

Pour obtenir des groupes de ressources qui ont un nom et une valeur d’étiquette spécifiques, utilisez :

az group list --tag Dept=Finance

Supprimer des étiquettes

Pour supprimer des étiquette spécifiques, utilisez az tag update et définissez --operation sur Delete. Transmettez les ID de ressource des étiquettes que vous souhaitez supprimer.

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

Vous avez supprimé les étiquettes spécifiées.

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

Pour supprimer toutes les étiquettes, utilisez la commande az tag delete.

az tag delete --resource-id $resource

Gestion des espaces

Si les noms ou les valeurs de vos étiquettes comportent des espaces, mettez-les entre guillemets.

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

Modèles ARM

Vous pouvez baliser les ressources, les groupes de ressources et les abonnements pendant le déploiement avec un modèle ARM.

Notes

Les étiquettes que vous appliquez via un modèle ARM ou un fichier Bicep remplacent toutes les étiquettes existantes.

Appliquer les valeurs

L’exemple suivant déploie un compte de stockage avec trois étiquettes. Deux des étiquettes (Dept et Environment) sont définies sur des valeurs littérales. Une étiquette (LastDeployed) a pour valeur un paramètre dont la valeur par défaut est la date actuelle.

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

Appliquer un objet

Vous pouvez définir un paramètre d’objet qui stocke plusieurs balises et appliquer cet objet à l’élément de balise. Cette approche offre plus de souplesse que l’exemple précédent, car l’objet peut avoir des propriétés différentes. Chaque propriété de l’objet devient une balise distincte pour la ressource. L’exemple suivant illustre un paramètre nommé tagValues appliqué à l’élément de balise.

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
}

Analyser une chaîne JSON

Pour stocker plusieurs valeurs dans une seule balise, appliquez une chaîne JSON qui représente les valeurs. La chaîne JSON complète est stockée sous la forme d’une balise ne pouvant pas dépasser 256 caractères. L’exemple illustre une balise unique nommée CostCenter qui contient plusieurs valeurs d’une chaîne JSON :

JSON
Bicep

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

param location string = resourceGroup().location

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

Appliquer des balises à partir d’un groupe de ressources

Pour appliquer des balises d’un groupe de ressources à une ressource, utilisez la fonction resourceGroup(). Lorsque vous obtenez 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.

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

Appliquer des étiquettes à des groupes de ressources ou à des abonnements

Vous pouvez ajouter des étiquettes à un groupe de ressources ou à un abonnement en déployant le type de ressource Microsoft.Resources/tags. Vous pouvez appliquer les étiquettes au groupe de ressources ou à l’abonnement cible que vous souhaitez déployer. Chaque fois que vous déployez le modèle, vous remplacez les étiquettes précédentes.

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

Pour appliquer les étiquettes à un groupe de ressources, utilisez Azure PowerShell ou Azure CLI. Déployez sur le groupe de ressources que vous souhaitez baliser.

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. Déployez sur l’abonnement que vous souhaitez baliser.

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.

Le modèle suivant ajoute les étiquettes depuis un objet vers un groupe de ressources ou un 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
  }
}

Portail

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. Pour plus d’informations, consultez le Tutoriel : Accorder un accès utilisateur aux ressources Azure à l’aide du contrôle RBAC et du portail Azure.

Pour afficher les balises d’une ressource ou d’un groupe de ressources, recherchez les balises existantes dans la vue d’ensemble. Si vous n’avez préalablement appliqué aucune balise, cette liste est vide.
Pour ajouter un mot clé, sélectionnez Cliquez ici pour ajouter des mots clés.
Donnez un nom et une valeur.
Continuez à ajouter les mots clés dont vous avez besoin. Lorsque vous avez terminé, sélectionnez Enregistrer.
Les mots clés sont maintenant affichés dans la vue d’ensemble.
Pour ajouter ou supprimer un mot clé, sélectionnez modifier.
Pour supprimer un mot clé, sélectionnez l’icône de la Corbeille. Sélectionnez ensuite Enregistrer.

Pour attribuer des balises en bloc à plusieurs ressources :

Dans une liste de ressources, cochez la case en regard des ressources auxquelles vous souhaitez attribuer le mot clé. Ensuite, sélectionnez Attribuer des étiquettes.
Ajoutez des noms et des valeurs. Lorsque vous avez terminé, sélectionnez Enregistrer.

Pour afficher toutes les ressources ayant un mot clé :

Dans le menu du portail Azure, recherchez étiquettes. Sélectionnez-le parmi les options disponibles.
Sélectionnez le mot clé pour afficher les ressources associées.
Toutes les ressources associées à ce mot clé sont affichées.

API REST

Pour travailler avec des étiquettes par le biais de l’API REST Azure, utilisez :

Étiquettes - Créer ou mettre à jour au niveau de l’étendue (opération PUT)
Balises - Mettre à jour au niveau de l’étendue (opération PATCH)
Étiquettes - Obtenir au niveau de l’étendue (opération GET)
Étiquettes - Supprimer au niveau de l’étendue (opération DELETE)

SDK

Pour voir des exemples d’application de balises avec des SDK, consultez :

Hériter des étiquettes

Les ressources n’héritent pas des balises que vous appliquez à un groupe de ressources ou à un abonnement. Pour appliquer des balises d’un abonnement ou d’un groupe de ressources aux ressources, consultez Stratégies Azure - Étiquettes.

Étiquettes et facturation

Vous pouvez utiliser des étiquettes pour regrouper vos données de facturation. 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. 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.

Vous pouvez récupérer des informations sur les étiquettes en téléchargeant le fichier d’utilisation disponible à partir du portail Azure. Pour plus d’informations, consultez Télécharger et consulter votre facture Azure et vos données d’utilisation quotidienne. Pour les services qui prennent en charge les étiquettes avec la facturation, les étiquettes s'affichent dans la colonne Étiquettes.

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

Limites

Les limites suivantes s’appliquent aux balises :

Les types de ressources ne prennent pas tous en charge les étiquettes. Pour déterminer si vous pouvez appliquer une étiquette à un type de ressource, consultez Prise en charge des étiquettes pour les ressources Azure.
Chaque ressource, groupe de ressources et abonnement peuvent inclure un maximum de 50 paires nom-valeur d’étiquette. Si vous devez appliquer plus de balises que le nombre maximal autorisé, utilisez une chaîne JSON comme valeur de balise. La chaîne JSON peut contenir plusieurs valeurs appliquées à un seul nom d’étiquette. Un groupe de ressources ou un abonnement peut contenir de nombreuses ressources qui ont chacune 50 paires nom-valeur d’étiquette.
Le nom de l’étiquette a une limite de 512 caractères et la valeur de l’étiquette a une limite de 256 caractères. Pour des comptes de stockages, le nom de l’étiquette a une limite de 128 caractères et la valeur de l’étiquette a une limite de 256 caractères.
Les ressources classiques telles que Cloud Services ne prennent pas en charge les étiquettes.
Les groupes IP Azure et les stratégies du pare-feu Azure ne prennent pas en charge les opérations PATCH. Les opérations de méthode d’API PATCH ne peuvent donc pas mettre à jour les étiquettes via le portail. Au lieu de cela, vous pouvez préférer les commandes de mise à jour pour ces ressources. Par exemple, vous pouvez mettre à jour les balises d’un groupe d’adresses IP à l’aide de la commande az network ip-group update.
Les noms de balise ne peuvent pas contenir ces caractères : <, >, %, &, \, ?, /
Notes
- Les zones Azure Domain Name System (DNS) ne prennent pas en charge l’utilisation d’espaces dans l’étiquette, ni une étiquette commençant par un chiffre. Les noms des étiquettes Azure DNS ne prennent pas en charge les caractères spéciaux et Unicode. La valeur peut contenir tous les caractères.
- Traffic Manager ne prend pas en charge l’utilisation de # ou : dans le nom de l’étiquette. Le nom de l’étiquette ne peut pas commencer par un chiffre.
- Azure Front Door ne prend pas en charge l’utilisation de # ou : dans le nom de la balise.
- Les ressources Azure suivantes prennent uniquement en charge 15 balises :
  - Azure Automation
  - Azure Content Delivery Network (CDN)
  - Azure DNS (Zone et enregistrements A)
  - Recherche enregistrée Azure Log Analytics

Étapes suivantes

Les types de ressources ne prennent pas tous en charge les étiquettes. Pour déterminer si vous pouvez appliquer une étiquette à un type de ressource, consultez Prise en charge des étiquettes pour les ressources Azure.
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.

Utiliser des étiquettes pour organiser vos ressources Azure et votre hiérarchie de gestion

Accès requis

PowerShell

Appliquer des étiquettes

Liste par étiquette

Supprimer des étiquettes

Azure CLI

Appliquer des étiquettes

Liste par étiquette

Supprimer des étiquettes

Gestion des espaces

Modèles ARM

Appliquer les valeurs

Appliquer un objet

Analyser une chaîne JSON

Appliquer des balises à partir d’un groupe de ressources

Appliquer des étiquettes à des groupes de ressources ou à des abonnements

Portail

API REST

SDK

Hériter des étiquettes

Étiquettes et facturation

Limites

Étapes suivantes

Ressources supplémentaires

Ressources supplémentaires

Utiliser des étiquettes pour organiser vos ressources Azure et votre hiérarchie de gestion

Accès requis

PowerShell

Appliquer des étiquettes

Répertorier les balises

Liste par étiquette

Supprimer des étiquettes

Azure CLI

Appliquer des étiquettes

Répertorier les balises

Liste par étiquette

Supprimer des étiquettes

Gestion des espaces

Modèles ARM

Appliquer les valeurs

Appliquer un objet

Analyser une chaîne JSON

Appliquer des balises à partir d’un groupe de ressources

Appliquer des étiquettes à des groupes de ressources ou à des abonnements

Portail

API REST

SDK

Hériter des étiquettes

Étiquettes et facturation

Limites

Étapes suivantes

Ressources supplémentaires

Ressources supplémentaires