Appliquer des étiquettes avec Azure CLI

  • Article

Cet article explique comment utiliser Azure CLI pour ajouter des étiquettes à des ressources, des groupes de ressources et des abonnements. Pour obtenir les recommandations et limitations des balises, consultez Utiliser des balises pour organiser vos ressources Azure et votre hiérarchie de gestion.

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

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 :

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"

Répertorier les balises

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"

Étapes suivantes