az account alias create |
Azure : Crée un alias de compte |
|---|---|
| Azure CLI | |
Syntaxe
| az account alias create --name [--billing-scope] [--display-name] [--no-wait] [--reseller-id] [--subscription-id] [--workload {DevTest, Production}] |
Paramètres
| Nom | Description |
|---|---|
| --billing-scope | Ce paramètre permet d'indiquer la portée de la facturation. Il détermine si l'abonnement est Field-Led, Partner-Led ou LegacyEA. |
| --debug | Ce paramètre permet d'augmenter les détails du journal de bord pour afficher tous les journals de bord de débogage. |
| --display-name | Ce paramètre permet d'indiquer le nom convivial de l'abonnement. |
| -h | Ce paramètre permet d'afficher le message d'aide et de quitter. |
| --help | Ce paramètre permet d'afficher le message d'aide et de quitter. |
| -n | Ce paramètre permet d'indiquer le nom de l'alias. |
| --name | Ce paramètre permet d'indiquer le nom de l'alias. |
| --no-wait | Ce paramètre permet de ne pas attendre la fin de l'opération de longue durée. |
| -o | Ce paramètre permet d'indiquer le format de sortie. |
| --only-show-errors | Ce paramètre permet d'afficher uniquement les erreurs, en supprimant les avertissements. |
| --output | Ce paramètre permet d'indiquer le format de sortie. |
| --query | Ce paramètre permet d'indiquer la chaîne de caractères requête JMESPath. |
| --reseller-id | Ce paramètre permet d'indiquer l'identificateur de revendeur, essentiellement l'identificateur MPN. |
| --subscription-id | Ce paramètre permet de créer un alias pour l'identificateur d'abonnement existant. |
| --verbose | Ce paramètre permet d'augmenter les détails du journal de bord. Utilisez --debug pour les journals de bord de débogage complets. |
| --workload | Ce paramètre permet d'indiquer le type de charge de travail de l'abonnement. Il peut s'agir de Production ou de DevTest. |
Description
Cette commande permet de créer un alias d'abonnement.
Remarques
- Création d'abonnements aliasés personnalisés : La commande az account alias create permet de créer un alias unique pour un abonnement Azure. Cela est particulièrement utile dans les environnements où plusieurs abonnements sont utilisés, car cela simplifie leur identification et leur gestion sans avoir à retenir l'ID complexe de chaque abonnement.
- Paramètre --name obligatoire et central : Le paramètre --name (ou -n) est obligatoire, car il détermine l'identifiant de l'alias à créer. Cet alias doit être unique dans le contexte du tenant Azure. Il sert ensuite de raccourci pour accéder rapidement à un abonnement sans utiliser l'UUID de celui-ci.
- Utilisation du paramètre --display-name pour la lisibilité : Le paramètre --display-name permet d'attribuer un nom convivial à l'abonnement associé. Contrairement à --name, qui est un identifiant technique, --display-name améliore la lisibilité dans le portail Azure et dans les scripts automatisés.
- Support de scénarios partenaires grâce à --reseller-id : Avec --reseller-id, la commande prend en charge les scénarios de revente (MPN ID). Cela permet aux partenaires Microsoft de gérer des abonnements pour leurs clients tout en conservant une traçabilité claire du revendeur impliqué.
- Paramètre --billing-scope pour contrôler le modèle de facturation : Le paramètre --billing-scope est utile pour définir si l'abonnement est rattaché à une facturation directe, à un partenaire ou à une entité EA (Enterprise Agreement). Cela permet une meilleure intégration dans les structures financières et organisationnelles complexes.
- Exécution asynchrone avec --no-wait : Le paramètre --no-wait permet de lancer la commande sans attendre que l'opération soit terminée. Cela est essentiel dans les pipelines CI/CD ou les scripts automatisés où l'on souhaite paralléliser les tâches sans blocage.
- Possibilités de débogage et de personnalisation de la sortie : Les options --debug, --verbose, --output et --query permettent de contrôler finement les messages affichés, ce qui est très utile pour le diagnostic et l'automatisation. Par exemple, --output json permet d'intégrer facilement le résultat dans un script de traitement.
- Support des types de charge via --workload : Le paramètre --workload permet de spécifier le profil d'usage de l'abonnement : soit Production, soit DevTest. Cela peut influencer certains comportements par défaut d'Azure, notamment sur les coûts ou les limitations, et permet une gestion plus structurée des environnements.
Exemple
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" |
Dernière mise à jour : Dimanche, le 4 Avril 2021