Condividi tramite

Panoramica: Terminologia e livelli di supporto dell'interfaccia della riga di comando di Azure

  • Articolo

Questo articolo illustra le terminologie dell'interfaccia della riga di comando di Azure. Sono disponibili componenti di sintassi, tipi di riferimento e stati.

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
Rete di Azure 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
rete application-gateway private-link ip-config add

Per un elenco completo dei comandi di riferimento, vedere l'elenco di riferimenti da A a Z .

Che cos'è il tipo 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 Memoria centrale Estensione
Riferimenti Fanno parte del servizio primario dell'interfaccia della riga di comando di Azure Sono comandi di riferimento facoltativi che devono essere installati
Installa Insieme al programma di installazione MSI Singolarmente con az extension add
Versione In base a pianificazione Quando diventano disponibili nuove funzionalità o aggiornamenti
Stato Può essere disponibile a livello generale (disponibile a livello generale), anteprima o deprecata Può anche essere disponibile a livello generale, anteprima o deprecato

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

Memoria centrale

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 principali 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 sperimentali. Un singolo gruppo di riferimento, ad esempio az iot hub, può avere comandi core ed extension. Di seguito sono riportati due esempi:

Comando di riferimento completo Core Estensione
az iot hub list yes
az iot hub job list yes

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 deprecata. Si tratta dello stato del comando di riferimento (non di tipo) che determina la stabilità.

Disponibilità generale Anteprima pubblica Deprecato
Stabilità Permanente Può cambiare in risposta al feedback dei clienti. È soggetto alle condizioni delle anteprime di Microsoft Azure. Verrà rimosso.

Nota

Gli avvisi che indicano l'anteprima pubblica o deprecata fanno parte dell'output del comando dell'interfaccia della riga di comando di Azure e devono essere previsti.

La maggior parte dei comandi e dei parametri per un singolo riferimento ha un singolo stato, ma non sempre. Un riferimento ga che viene compilato per offrire più comandi può avere comandi di riferimento a livello generale e di anteprima. 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 Type Disponibilità generale Anteprima pubblica Deprecato
az network dns zone list Tutte le date Memoria centrale yes
az network dns zone create --name, --resource-group, --if-none-match, --parent-name Memoria centrale yes
--existingParameter5 Memoria centrale yes
--newParameter6 Memoria centrale yes
az network vhub list Tutte le date Extension yes
az network vhub create --address-prefix, --name, --resource-group, -vwan, --location, --sku Extension yes
--exsitingParameter7 Extension yes
--newParameter8 Extension yes
az network firewall create Tutte le date Extension yes

La tabella precedente è solo un esempio e non è rappresentativo degli stati di riferimento correnti per az network.

Vedi anche