Vue d’ensemble : terminologie et niveaux de support Azure CLI
Cet article explique les terminologies d’Azure CLI. Il existe des composants de syntaxe, des types de référence et des états. C’est l’état qui détermine le niveau de support.
Composants de la syntaxe d’Azure CLI
La syntaxe d’Azure CLI est une combinaison de groupes, de références, de commandes et de paramètres. La commande de référence complète est souvent juste appelée commande.
| Service Azure | Groupe de référence | Sous-groupe(s) de référence | Commande | Commande de référence complète | Exemples de paramètres |
|---|---|---|---|---|---|
| Azure CLI | az config | az config | --local, --output -o | ||
| Réseau Azure | az network | application-gateway | create | az network application-gateway create | --name, --resource-group, --capacity |
| Azure DevOps | az pipelines | agent | list | az pipelines agent list | --pool-id, --agent-name, --demands |
Un sous-groupe de référence peut avoir plusieurs niveaux tels que az network application-gateway private-link ip-config add
| Groupe de référence | Sous-groupe 1 | Sous-groupe 2 | Sous-groupe 3 | Commande |
|---|---|---|---|---|
| réseau | application-gateway | private-link | ip-config | add |
Consultez la liste de référence A-Z pour obtenir la liste complète des commandes de référence.
Qu’est-ce qu’un type de référence ?
Les commandes Azure CLI font partie du service Azure CLI principal ou constituent une extension. Les extensions sont des modules complémentaires facultatifs. Le type de référence détermine la planification de mise en production, l’état et la méthode d’installation, comme décrit ci-après :
| Terme | Core | Extension |
|---|---|---|
| Informations de référence | Font partie du service Azure CLI principal | Sont des commandes de références facultatives qui doivent être installées |
| Installer | Conjointement avec le programme d’installation MSI | Individuellement avec az extension add |
| Publication | Selon une planification | À mesure que de nouvelles fonctionnalités ou mises à jour sont disponibles |
| État | Peut être GA (Generally Available), préversion ou expérimental | Peut également être en disponibilité générale, en préversion ou expérimentale |
Pour obtenir la liste des groupes de commandes, exécutez az. Pour obtenir la liste des extensions, utilisez les commandes az extension list-available --output table.
# Get list of all command groups
az
# Get list of extensions
az extension list-available --output table
Core
Les références Azure CLI qui ont été publiées en tant que partie permanente de l’interface CLI sont appelées références principales. Toutes les références principales sont installées avec l’interface Azure CLI et vous ne pouvez pas choisir un sous-ensemble de références. Si vous exécutez l’interface CLI par le biais d’Azure Cloud Shell, les références principales sont toujours à jour.
Extension
Les extensions ne sont pas fournies dans le cadre de l’interface CLI mais elles sont exécutées en tant que commandes CLI. Certaines extensions font partie intégrante de l’interface Azure CLI, mais souvent, une extension vous permet d’accéder à la une préversion et aux commandes expérimentales. Un même groupe de références, comme az iot hub, peut avoir à la fois des commandes principales et des commandes d’extension. Voici deux exemples :
| Commande de référence complète | Est une commande principale | Est une commande d’extension |
|---|---|---|
| az iot hub list | Oui | |
| az iot hub job list | Oui |
Vous êtes invité à installer une extension lors de la première utilisation. Vous pouvez également installer une extension en exécutant la commande az extension add.
Vous pouvez en savoir plus sur les références d’extension, notamment l’installation et la mise à jour dans Utiliser des extensions avec l’interface Azure CLI. Pour obtenir la liste complète des commandes de références d’extension, consultez Extensions disponibles pour Azure CLI.
Qu’est-ce qu’un état de référence ?
Quel que soit le type de référence, les références Azure CLI se répartissent en trois catégories d’états : disponibilité générale (GA), préversion publique ou expérimental. Il s’agit de l’état, et non du type, des commandes de références qui détermine la stabilité et le niveau de support.
| GA | Préversion publique | Expérimental | |
|---|---|---|---|
| Stabilité | Permanent | Peut changer en réponse aux commentaires des clients. Est soumis aux conditions d’utilisation des préversions de Microsoft Azure. | Peut changer en réponse aux commentaires des clients. Migre souvent vers la préversion publique. Peut être supprimé. |
| Niveau de support | Complète | Partial | None |
Notes
Les avertissements signalant préversion publique ou expérimental font partie de la sortie de la commande Azure CLI et il faut s’attendre à les voir.
La plupart des commandes et des paramètres d’une référence unique ont un seul état, mais pas toujours. Une référence GA qui est conçue pour offrir plus de commandes peut avoir des commandes de références en GA, en préversion et expérimentales. À mesure que de nouveaux paramètres sont ajoutés pour améliorer les fonctionnalités, une même commande peut également avoir des paramètres qui appartiennent à différentes catégories d’état. Voici des exemples de références qui ont différents états :
| Commande de référence complète | Paramètres | Type | GA | Préversion publique | Expérimental |
|---|---|---|---|---|---|
| az network dns zone list | Tous | Core | Oui | ||
| az network dns zone create | --name, --resource-group, --if-none-match, --parent-name | Core | Oui | ||
| --newFutureParameter1 | Core | Oui | |||
| --newFutureParameter2 | Core | Oui | |||
| az network vhub list | Tous | Extension | Oui | ||
| az network vhub create | --address-prefix, --name, --resource-group, -vwan, --location, --sku | Extension | Oui | ||
| --newFutureParameter1 | Extension | Oui | |||
| --newFutureParameter2 | Extension | Oui | |||
| az network firewall create | Tous | Extension | Oui |
Le tableau ci-dessus n’est qu’un exemple et n’est pas représentatif de l’état actuel des références pour les exemples.