Partager via

az tag

  • Référence

Gestion des étiquettes sur une ressource.

Commandes

Nom Description Type État
az tag add-value

Créez une valeur d’étiquette.

 Core GA
az tag create

Créez des balises sur une ressource spécifique.

 Core GA
az tag delete

Supprimez des balises sur une ressource spécifique.

 Core GA
az tag list

Répertoriez l’ensemble des balises sur une ressource spécifique.

 Core GA
az tag remove-value

Supprime une valeur d’étiquette prédéfinie pour un nom de balise prédéfini.

 Core GA
az tag update

Mettez à jour de manière sélective l’ensemble d’étiquettes sur une ressource spécifique.

 Core GA

az tag add-value

Modifier

Créez une valeur d’étiquette.

az tag add-value --name
                 --value

Exemples

Créez une valeur d’étiquette.

az tag add-value --name MyTag --value MyValue

Paramètres obligatoires

--name -n

Nom de la balise.

--value

Valeur de la balise.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az tag create

Modifier

Créez des balises sur une ressource spécifique.

La commande az tag create avec un ID crée ou met à jour l’ensemble des balises sur une ressource, un groupe de ressources ou un abonnement. Cette opération permet d’ajouter ou de remplacer l’ensemble des balises sur la ressource, le groupe de ressources ou l’abonnement spécifiés. L’entité spécifiée peut avoir un maximum de 50 balises. Remarque : « tag create » agit comme un « tag init », donc les balises créées avec cette commande sont les seules présentes après l’exécution.

az tag create [--name]
              [--resource-id]
              [--tags]

Exemples

Créez une balise dans l’abonnement.

az tag create --name MyTag

Créez ou mettez à jour l’ensemble des balises sur un abonnement.

az tag create --resource-id /subscriptions/{subId} --tags Dept=Finance Status=Normal

Créez ou mettez à jour l’ensemble des balises sur un groupe de ressources.

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --tags Dept=Finance Status=Normal

Créez ou mettez à jour l’ensemble des balises sur une ressource.

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --tags Dept=Finance Status=Normal

Paramètres facultatifs

--name -n

Nom de la balise à créer.

--resource-id

Identificateur de ressource de l’entité étiquetée. Une ressource, un groupe de ressources ou un abonnement peut être marqué.

--tags

Balises à appliquer à la ressource.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az tag delete

Modifier

Supprimez des balises sur une ressource spécifique.

La commande az tag delete avec un ID supprime l’ensemble des balises d’une ressource, d’un groupe de ressources ou d’un abonnement.

az tag delete [--name]
              [--resource-id]
              [--yes]

Exemples

Supprimez une balise prédéfinie de l’abonnement non associé à une ressource ou n’ayant aucune valeur d’étiquette.

az tag delete --name MyTag

Supprimez l’ensemble des balises d’un abonnement.

az tag delete --resource-id /subscriptions/{sub-id}

Supprimez l’ensemble des balises d’un groupe de ressources.

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

Supprimez l’ensemble des balises d’une ressource. (Même en utilisant --name avec --resource-id pour spécifier une balise unique)

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

Paramètres facultatifs

--name -n

Nom de la balise à supprimer.

--resource-id

Identificateur de ressource de l’entité étiquetée. Une ressource, un groupe de ressources ou un abonnement peut être marqué.

--yes -y

Ne pas demander de confirmation.

Valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az tag list

Modifier

Répertoriez l’ensemble des balises sur une ressource spécifique.

La commande az tag list avec un ID répertorie l’ensemble des balises sur une ressource, un groupe de ressources ou un abonnement.

az tag list [--resource-id]

Exemples

Répertoriez l’ensemble des balises d’un abonnement.

az tag list --resource-id /subscriptions/{sub-id}

Répertoriez l’ensemble des balises d’un groupe de ressources.

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

Répertoriez l’ensemble des balises d’une ressource.

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

Paramètres facultatifs

--resource-id

Identificateur de ressource de l’entité étiquetée. Une ressource, un groupe de ressources ou un abonnement peut être marqué.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az tag remove-value

Modifier

Supprime une valeur d’étiquette prédéfinie pour un nom de balise prédéfini.

Cette opération permet de supprimer une valeur de la liste des valeurs prédéfinies pour un nom de balise prédéfini existant. La valeur supprimée ne doit pas être utilisée comme valeur d’étiquette pour le nom de balise donné pour n’importe quelle ressource.

az tag remove-value --name
                    --value

Paramètres obligatoires

--name -n

Nom de la balise.

--value

Valeur de la balise.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az tag update

Modifier

Mettez à jour de manière sélective l’ensemble d’étiquettes sur une ressource spécifique.

La commande az tag update avec un ID met à jour sélectivement l’ensemble de balises sur une ressource, un groupe de ressources ou un abonnement. Cette opération permet de remplacer, fusionner ou supprimer sélectivement des balises sur la ressource, le groupe de ressources ou l’abonnement spécifiés. L’entité spécifiée peut avoir au maximum 50 balises à la fin de l’opération. L’option « replace » remplace l’ensemble entier des balises existantes par un nouveau jeu. L’option « fusionner » permet d’ajouter des balises avec de nouveaux noms et de mettre à jour les valeurs des balises avec des noms existants. L’option « delete » permet de supprimer sélectivement des balises en fonction des noms ou des paires nom/valeur donnés.

az tag update --operation {Delete, Merge, Replace}
              --resource-id
              --tags

Exemples

Mettez à jour sélectivement l’ensemble d’étiquettes sur un abonnement avec l’opération « fusion ».

az tag update --resource-id /subscriptions/{sub-id} --operation merge --tags key1=value1 key3=value3

Mettez à jour de manière sélective l’ensemble d’étiquettes sur un groupe de ressources avec l’opération « replace ».

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --operation replace --tags key1=value1 key3=value3

Mettez à jour de manière sélective l’ensemble d’étiquettes sur une ressource avec l’opération « delete ».

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --operation delete --tags key1=value1

Paramètres obligatoires

--operation

Opération de mise à jour. Les options sont Fusion, Remplacement et Suppression.

Valeurs acceptées: Delete, Merge, Replace
--resource-id

Identificateur de ressource de l’entité étiquetée. Une ressource, un groupe de ressources ou un abonnement peut être marqué.

--tags

Balises à mettre à jour sur la ressource.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.