Panoramica: Terminologia e livelli di supporto dell'interfaccia della riga di comando di Azure
Questo articolo illustra le terminologie dell'interfaccia della riga di comando di Azure. Sono disponibili componenti di sintassi, tipi di riferimento e stati. è lo stato che determina il livello di supporto.
Componenti della sintassi dell'interfaccia della riga di comando di Azure
La sintassi dell'interfaccia della riga di comando di Azure è una combinazione di gruppi, riferimenti, comandi e parametri. Spesso il comando di riferimento completo viene semplicemente definito comando.
| Servizio di Azure | Gruppo di riferimenti | Sottogruppi di riferimento | Comando | Comando di riferimento completo | Esempi di parametri |
|---|---|---|---|---|---|
| Interfaccia della riga di comando di Azure | az config | az config | --local, --output -o | ||
| Azure Network | az network | application-gateway | create | az network application-gateway create | --name, --resource-group, --capacity |
| Azure DevOps | az pipelines | agente | list | az pipelines agent list | --pool-id, --agent-name, --demands |
Un sottogruppo di riferimento può avere più livelli, ad esempio az network application-gateway private-link ip-config add
| Gruppo di riferimento | Sottogruppo 1 | Sottogruppo 2 | Sottogruppo 3 | Comando |
|---|---|---|---|---|
| network | application-gateway | collegamento privato | ip-config | add |
Per un elenco completo di comandi di riferimento, vedere l'elenco di riferimenti da A a Z .
Che cos'è il tipo di riferimento?
I comandi dell'interfaccia della riga di comando di Azure fanno parte del servizio principale dell'interfaccia della riga di comando di Azure o sono un'estensione. Le estensioni sono componenti aggiuntivi facoltativi. Il tipo di riferimento determina la pianificazione del rilascio, lo stato e il metodo di installazione, come descritto di seguito:
| Termine | Core | Estensione |
|---|---|---|
| Riferimenti | Fanno parte del servizio primario dell'interfaccia della riga di comando di Azure | Sono comandi di riferimento facoltativi che devono essere installati |
| Installazione | Insieme al programma di installazione MSI | Singolarmente con az extension add |
| Rilasciato | In base a una pianificazione | Quando diventano disponibili nuove funzionalità o aggiornamenti |
| Status | Può essere disponibilità generale, anteprima o sperimentale | Può anche essere disponibilità generale, anteprima o sperimentale |
Per ottenere un elenco di gruppi di comandi, eseguire az. Per un elenco di estensioni, usare i comandi az extension list-available --output table .
# Get list of all command groups
az
# Get list of extensions
az extension list-available --output table
Core
I riferimenti dell'interfaccia della riga di comando di Azure pubblicati come parte permanente dell'interfaccia della riga di comando sono denominati riferimenti core. Tutti i riferimenti di base vengono installati con l'interfaccia della riga di comando di Azure e non è possibile scegliere un subset di riferimenti. Se si esegue l'interfaccia della riga di comando tramite Azure Cloud Shell, i riferimenti core sono sempre aggiornati.
Estensione
Le estensioni non vengono fornite con l'interfaccia della riga di comando, ma vengono eseguite come comandi dell'interfaccia della riga di comando. Alcune estensioni sono una parte permanente dell'interfaccia della riga di comando di Azure, ma spesso un'estensione consente di accedere ai comandi di anteprima e sperimentale. Un singolo gruppo di riferimento, ad esempio az iot hub, può avere comandi di base ed estensione. Di seguito sono riportati due esempi:
| Comando di riferimento completo | Core | Estensione |
|---|---|---|
| az iot hub list | sì | |
| az iot hub job list | sì |
Viene richiesto di installare un'estensione al primo uso. È anche possibile installare un'estensione eseguendo il comando az extension add .
Per altre informazioni sui riferimenti alle estensioni, tra cui installazione e aggiornamento, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure. Per un elenco completo dei comandi di riferimento di estensione, vedere Estensioni disponibili per l'interfaccia della riga di comando di Azure.
Che cos'è lo stato di riferimento?
Indipendentemente dal tipo di riferimento, i riferimenti all'interfaccia della riga di comando di Azure rientrano in tre categorie di stato: disponibilità generale (disponibile a livello generale), anteprima pubblica o sperimentale. Si tratta dello stato del comando di riferimento (non di tipo) che determina la stabilità e il livello di supporto.
| GA | Anteprima pubblica | Sperimentale | |
|---|---|---|---|
| Stabilità | Permanente | Può cambiare in risposta al feedback dei clienti. È soggetto alle condizioni delle anteprime di Microsoft Azure. | Può cambiare in risposta al feedback dei clienti. Spesso esegue la migrazione all'anteprima pubblica. Si può rimuovere. |
| Livello di supporto | Full | Parziale | Nessuno |
Nota
Gli avvisi che indicano anteprima pubblica o sperimentale fanno parte dell'output dei comandi dell'interfaccia della riga di comando di Azure e sono previsti.
La maggior parte dei comandi e dei parametri per un singolo riferimento ha un singolo stato, ma non sempre. Un riferimento in disponibilità generale creato per offrire più comandi può includere comandi di riferimento in disponibilità generale, in anteprima e sperimentali. Quando vengono aggiunti nuovi parametri per aumentare la funzionalità, un singolo comando può avere anche parametri che rientrano in categorie di stato diverse. Di seguito sono riportati alcuni riferimenti di esempio con stati diversi:
| Comando di riferimento completo | Parametri | Tipo | GA | Anteprima pubblica | Sperimentale |
|---|---|---|---|---|---|
| az network dns zone list | Tutti | Core | sì | ||
| az network dns zone create | --name, --resource-group, --if-none-match, --parent-name | Core | sì | ||
| --newFutureParameter1 | Core | sì | |||
| --newFutureParameter2 | Core | sì | |||
| az network vhub list | Tutti | Estensione | sì | ||
| az network vhub create | --address-prefix, --name, --resource-group, -vwan, --location, --sku | Estensione | sì | ||
| --newFutureParameter1 | Estensione | sì | |||
| --newFutureParameter2 | Estensione | sì | |||
| az network firewall create | Tutti | Estensione | sì |
La tabella precedente è solo un esempio e non è rappresentativa dello stato di riferimento corrente per esempi.