az account management-group |
Azure : Groupe de gestion du compte |
|---|---|
| Azure CLI | |
Syntaxe
| az account management-group create --name [--display-name] [--parent] |
| az account management-group delete --name |
| az account management-group list [--query-examples] |
| az account management-group show --name [--expand] [--query-examples] [--recurse] |
| az account management-group update --name [--add] [--display-name] [--force-string] [--parent] [--remove] [--set] |
Paramètres
| Nom | Description |
|---|---|
| --add | Ce paramètre permet d'ajouter de nouvelles paires clé/valeur à une liste de propriétés. |
| --debug | Ce paramètre permet d'augmenter la verbosité de la journalisation pour afficher tous les journaux de débogage. |
| --display-name | Ce paramètre permet de définir le nom d'affichage convivial pour le groupe de gestion. |
| --expand | Ce paramètre permet d'inclure des informations supplémentaires, comme les enfants et les abonnements, lors de l'affichage des détails du groupe de gestion. |
| --force-string | Ce paramètre permet de traiter les paires clé/valeur comme des chaînes lors de l'ajout ou de la mise à jour, utile pour éviter les problèmes de typage. |
| -h | Ce paramètre permet d'afficher le message d'aide pour cette commande et de quitter. |
| --help | Ce paramètre permet d'afficher le message d'aide pour cette commande et de quitter. |
| --name | Ce paramètre permet de spécifier le nom unique (ID) du groupe de gestion. |
| -o | Ce paramètre permet de définir le format de sortie des résultats. Les valeurs acceptées incluent json, jsonc, none, table, tsv, yaml, et yamlc. Le format par défaut est json. |
| --only-show-errors | Ce paramètre permet d'afficher uniquement les messages d'erreur, en supprimant les avertissements pour une sortie plus concise. |
| --output | Ce paramètre permet de définir le format de sortie des résultats. Les valeurs acceptées incluent json, jsonc, none, table, tsv, yaml, et yamlc. Le format par défaut est json. |
| --parent | Ce paramètre permet de spécifier l'ID du groupe de gestion parent pour organiser la hiérarchie. |
| --query | Ce paramètre permet de spécifier une chaîne de requête JMESPath pour personnaliser la sortie de la commande. Vous pouvez trouver plus d'informations et d'exemples sur http://jmespath.org/. |
| --query-examples | Ce paramètre permet de fournir des exemples de requêtes JMESPath courantes pour cette commande, ce qui peut vous aider à mieux manipuler la sortie. Il n'affecte pas les résultats réels de la commande. |
| --recurse | Ce paramètre permet d'afficher les groupes de gestion et abonnements enfants de manière récursive jusqu'à la racine. |
| --remove | Ce paramètre permet de supprimer une propriété ou un élément d'une liste par nom ou condition. |
| --set | Ce paramètre permet de mettre à jour une propriété existante ou d'en ajouter une si elle n'existe pas. |
| --subscription | Ce paramètre permet de spécifier le nom ou l'ID de l'abonnement Azure sur lequel opérer. Vous pouvez configurer l'abonnement par défaut en utilisant az account set -s NAME_OR_ID. |
| --verbose | Ce paramètre permet d'augmenter le niveau de verbosité de la journalisation. Pour des journaux de débogage complets, utilisez --debug. |
Description
Cette commande permet de gérer les groupes de gestion Azure.
Remarques
- Regrouper des abonnements pour une gestion centralisée : La commande az account management-group permet d'organiser plusieurs abonnements Azure sous une structure hiérarchique logique. Cela simplifie la gestion à grande échelle, notamment en matière de gouvernance, de politiques de sécurité (Azure Policy), et de contrôle d'accès (RBAC).
- Permet la création de groupes avec hiérarchie personnalisée : Grâce au paramètre --parent, il est possible de créer une structure de groupes imbriqués. Cela est utile pour refléter une organisation interne (par département, entité, projet) tout en assurant une séparation claire entre les différentes unités de gestion.
- Affichage étendu et hiérarchique avec --expand et --recurse : Lorsqu'on affiche les détails d'un groupe avec show, les paramètres --expand et --recurse permettent de visualiser la structure complète des enfants et abonnements associés. Cela fournit une vue claire de la disposition hiérarchique sans devoir appeler plusieurs commandes séparées.
- Mise à jour flexible avec --add, --set, et --remove : Ces trois paramètres permettent de manipuler dynamiquement les propriétés d'un groupe de gestion. Cela rend les scripts d'automatisation plus efficaces, car on peut modifier des métadonnées ou ajuster des valeurs sans recréer le groupe.
- Nom d'affichage personnalisable avec --display-name : Le paramètre --display-name est utile pour fournir une désignation lisible par les utilisateurs (différente de l'ID technique), facilitant ainsi la compréhension et la navigation dans le portail Azure ou lors des requêtes CLI.
- Suppression sécurisée des groupes avec delete : La commande delete permet de retirer un groupe de gestion via son nom. Toutefois, cette opération ne peut s'effectuer que si le groupe ne contient ni sous-groupes ni abonnements. Cela renforce la cohérence structurelle et évite des suppressions accidentelles.
- Utilisation du --query-examples pour simplifier l'apprentissage : Le paramètre --query-examples fournit directement des modèles de requêtes JMESPath utilisables pour filtrer ou formater la sortie. Cela facilite l'apprentissage des expressions de requête complexes et accélère le développement de scripts CLI.
- Contrôle granulaire des sorties avec les formats --output et --only-show-errors : Comme avec les autres commandes Azure CLI, az account management-group permet d'ajuster la sortie selon le contexte : en mode script, on privilégiera json ou tsv ; en mode interactif, le format table est souvent plus lisible. On peut aussi limiter l'affichage aux erreurs pour ne pas polluer les journaux de bords.
Dernière mise à jour : Dimanche, le 4 Avril 2021