Partager via

Appliquer des balises avec Azure CLI

Cet article explique comment utiliser Azure CLI pour baliser des ressources, des groupes de ressources et des abonnements. Pour connaître les recommandations et les limitations des balises, consultez Utiliser des balises pour organiser vos ressources Azure et votre hiérarchie de gestion.

Appliquer des balises

Azure CLI propose deux commandes pour appliquer des balises : 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 mettre à jour ou l’installer, consultez Installer 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 de balises à 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 balises.

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

Si vous réexécutez la commande, mais cette fois avec différentes balises, notez que les balises antérieures disparaissent.

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

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

Pour ajouter des balises à une ressource qui a déjà des balises, 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 balises existantes augmentent avec l’ajout des deux nouvelles balises.

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

Chaque nom de balise ne peut avoir qu’une seule valeur. Si vous fournissez une nouvelle valeur pour une balise, la nouvelle balise remplace l’ancienne valeur, même si vous utilisez l’opération de fusion. L’exemple suivant modifie la Status balise 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 balises restent sur la ressource.

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

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

Pour ajouter un nouvel ensemble de balises à 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 balises d’un groupe de ressources, utilisez :

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

Pour ajouter un nouvel ensemble de balises à 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 balises d’un abonnement, utilisez :

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

Répertorier les balises

Pour obtenir les balises 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 balises 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 afficher les balises 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 balises d’un abonnement, utilisez :

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

Liste par balise

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 d’étiquette spécifique avec n’importe quelle valeur de balise, 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 l’ID de ressource des balises que vous souhaitez supprimer.

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

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

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

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

az tag delete --resource-id $resource

Gestion des espaces

Si vos noms ou valeurs d’étiquette incluent des espaces, placez-les entre guillemets.

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

Étapes suivantes

  • Last updated on