Logiciel en ligne - Azure - Commandes Azure (Azure CLI)

az account alias	Azure : Alias de compte
Azure CLI

Syntaxe

az account alias create --name [--billing-scope] [--display-name] [--no-wait] [--reseller-id] [--subscription-id] [--workload {DevTest, Production}]	Cette commande permet de créer un alias d'abonnement Azure. Elle associe un alias à un abonnement existant ou en provisionne un nouveau. L'alias peut être enrichi avec des métadonnées comme le nom d'affichage, l'étendue de facturation, l'identifiant du revendeur et le type de charge de travail (DevTest ou Production). Elle peut également être exécutée de manière asynchrone grâce à l'option --no-wait.
az account alias delete --name	Cette commande permet de supprimer un alias d'abonnement spécifié par son nom. Une fois supprimé, l'alias n'est plus utilisable pour référencer ou accéder à l'abonnement auquel il était lié.
az account alias list	Cette commande permet d'afficher la liste complète de tous les alias d'abonnement disponibles dans le compte Azure actuel. Elle retourne les informations de chaque alias, telles que le nom, l'ID d'abonnement associé, ou encore l'étendue de facturation.
az account alias show --name	Cette commande permet de récupérer les détails d'un alias d'abonnement spécifique, en le recherchant par son nom. Elle affiche les métadonnées associées à cet alias, comme le nom d'affichage, l'ID de l'abonnement, et d'autres propriétés.
az account alias wait --name [--created] [--custom] [--deleted] [--exists] [--interval] [--timeout] [--updated]	Cette commande permet d'attendre qu'un alias d'abonnement atteigne un certain état avant de continuer une exécution (par exemple : qu'il soit créé, supprimé, mis à jour ou qu'il existe). Elle est particulièrement utile dans les scripts automatisés ou les scénarios de déploiement dépendants de la disponibilité d'un alias.

Paramètres

Nom	Description
--name	Ce paramètre permet de spécifier le nom de l'alias d'abonnement à créer, consulter, supprimer ou attendre. Il sert d'identifiant principal de l'alias.
--billing-scope	Ce paramètre permet d'indiquer l'étendue de facturation liée à l'abonnement, comme un ID de groupe de facturation ou d'accord de facturation.
--display-name	Ce paramètre permet de définir un nom d'affichage lisible pour l'abonnement, différent de l'alias technique.
--no-wait	Ce paramètre permet de lancer la commande sans attendre la fin de l'opération. Il est utile dans les scripts désynchronisées ou les processus automatisés.
--reseller-id	Ce paramètre permet de spécifier un identifiant de revendeur dans un contexte CSP (Cloud Solution Provider).
--subscription-id	Ce paramètre permet de lier l'alias à un abonnement existant en fournissant directement son ID.
--workload	Ce paramètre permet de désigner le type de charge de travail associé à l'abonnement, avec comme choix possibles : DevTest ou Production.
--created	Ce paramètre permet d'attendre que l'alias soit complètement créé avant de continuer. Il est utilisé avec la commande wait.
--custom	Ce paramètre permet de définir une condition personnalisée à attendre avant de poursuivre, sous forme d'expression JMESPath.
--debug	Ce paramètre permet d'augmenter la verbosité de la journalisation pour afficher tous les journaux de débogage.
--deleted	Ce paramètre permet d'attendre que l'alias soit entièrement supprimé avant de continuer.
--exists	Ce paramètre permet de vérifier l'existence d'un alias et d'attendre que cette condition soit vraie.
-h	Ce paramètre permet d'afficher ce message d'aide et de quitter.
--help	Ce paramètre permet d'afficher ce message d'aide et de quitter.
--interval	Ce paramètre permet de spécifier l'intervalle en secondes entre chaque vérification d'état lors de l'attente d'une opération.
-o	Ce paramètre permet de définir le format de sortie pour la commande. Les valeurs acceptées sont : json, jsonc, none, table, tsv, yaml, yamlc. La valeur par défaut est json.
--only-show-errors	Ce paramètre permet d'afficher uniquement les erreurs, en supprimant les avertissements.
--output	Ce paramètre permet de définir le format de sortie pour la commande. Les valeurs acceptées sont : json, jsonc, none, table, tsv, yaml, yamlc. La valeur par défaut est json.
--query	Ce paramètre permet de spécifier une chaîne de requête JMESPath pour filtrer ou formater la sortie de la commande. Vous pouvez trouver plus d'informations et d'exemples sur http://jmespath.org/.
--subscription	Ce paramètre permet de spécifier le nom ou l'ID de l'abonnement sur lequel opérer. Vous pouvez configurer l'abonnement par défaut en utilisant az account set -s NAME_OR_ID.
--timeout	Ce paramètre permet de définir la durée maximale d'attente pour qu'une condition soit remplie.
--updated	Ce paramètre permet d'attendre que l'alias soit mis à jour avec succès.
--verbose	Ce paramètre permet d'augmenter le niveau de verbosité de la journalisation. Utilisez --debug pour obtenir des journaux de débogage complets.

Description

Cette commande permet de gérer l'alias d'abonnement.

Remarques

La commande az account alias simplifie la gestion des alias d'abonnement dans Azure : Elle permet de créer, afficher, supprimer et attendre des alias d'abonnement, offrant ainsi une couche d'abstraction utile pour automatiser ou standardiser la création d'environnements Azure à grande échelle.
L'option --name est obligatoire pour presque toutes les sous-commandes : Elle désigne l'alias d'abonnement que l'on veut manipuler, que ce soit pour le créer, le supprimer ou le consulter. Il est donc crucial de choisir des noms d'alias clairs et cohérents pour éviter toute confusion lors de leur gestion ultérieure.
La sous-commande create permet de créer un alias en liant plusieurs informations importantes : Elle accepte des paramètres comme --billing-scope pour la portée de facturation, --subscription-id pour associer un abonnement existant, ou encore --workload pour indiquer le type d'environnement (DevTest ou Production). Cela permet d'adapter précisément la configuration à chaque besoin métier.
Grâce à --display-name, il est possible de fournir un nom lisible à l'abonnement : Cela améliore la clarté et l'organisation dans les portails d'administration, en affichant un nom distinct de l'ID de l'alias. Cette option est particulièrement utile lorsqu'on déploie plusieurs abonnements en parallèle dans différents environnements.
La commande delete est utile pour nettoyer des alias obsolètes ou inutilisés : Supprimer un alias peut éviter des confusions dans les scripts automatisés et permet de maintenir un environnement Azure propre et à jour. Cependant, il faut faire attention à ne pas supprimer un alias actif ou encore utilisé.
az account alias wait permet une synchronisation dans les scripts d'automatisation : Elle est précieuse pour attendre la fin d'une opération (--created, --deleted,...) avant de passer à l'étape suivante dans un script. Cela évite des erreurs dues à des traitements asynchrones qui ne seraient pas encore finalisés.
La commande list donne une vue d'ensemble de tous les alias existants : Cela permet de vérifier quels alias sont actuellement actifs, de les trier ou de les filtrer selon les besoins. C'est un outil important pour les administrateurs infonuagique devant superviser plusieurs abonnements répartis entre projets ou équipes.
Cette commande est particulièrement pertinente dans les scénarios d'entreprise à grande échelle : Lorsqu'une organisation gère des dizaines, voire des centaines d'abonnements Azure, les alias permettent une gestion centralisée, plus simple et plus compréhensible pour les équipes DevOps, FinOps et sécurité.

Exemples

L'exemple suivant permet de créer un alias :

az account alias create --name "aliasForNewSub" --billing-scope "/providers/Microsoft.Billing/billingAccounts/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx:024cabf4-7321-4cf9-be59-df0c77ca51de_2019-05-31/billingProfiles/PE2Q-NOIT-BG7-TGB/invoiceSections/MTT4-OBS7-PJA-TGB" --display-name "Contoso MCA subscription" --workload "Production"

L'exemple suivant permet de supprimer un alias :

az account alias delete --name "aliasForNewSub"

L'exemple suivant permet d'afficher la liste des alias :

az account alias list

L'exemple suivant permet de demander l'alias "aliasForNewSub" :

az account alias show --name "aliasForNewSub"

L'exemple suivant permet de suspendre l'exécution de la ligne suivante du script CLI jusqu'à ce que l'alias de compte soit créé avec succès :

az account alias wait --name "aliasForNewSub" --created

Dernière mise à jour : Dimanche, le 4 Avril 2021

Section courante

A propos

Section administrative du site

az account alias

Syntaxe

Paramètres

Description

Remarques

Exemples