Condividi tramite

Panoramica: Terminologia e livelli di supporto di Azure CLI

  • 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 CLI di Azure az config az config --local, --output -o
Rete di Azure az network application-gateway creare az network application-gateway create (comando per creare un gateway applicativo di rete) --name (nome), --resource-group (gruppo risorse), --capacity (capacità)
Azure DevOps az pipelines agente lista elenco agenti pipelines az --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 collegamento privato configurazione IP Aggiungere

Per un elenco completo dei 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 Azure CLI core, oppure 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 Nucleo Estensione
Riferimenti Fanno parte del servizio principale di Azure CLI Sono comandi di riferimento facoltativi che devono essere installati
Installa Insieme al programma di installazione MSI Individualmente con az extension add
Rilasciato Secondo il programma Quando diventano disponibili nuove funzionalità o aggiornamenti
Stato Può essere generalmente disponibile, in anteprima o obsoleta 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 az extension list-available --output table.

# Get list of all command groups
az

# Get list of extensions
az extension list-available --output table

Nucleo

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 sono incluse nella CLI, ma vengono eseguite come comandi CLI. 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 È un'estensione
Comando "az iot hub list" per elencare gli hub IoT. Sì
az iot hub job list (Elenco dei lavori dell'hub IoT) 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 deprecata. Si tratta dello stato del comando di riferimento (non di tipo) che determina la stabilità.

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

Annotazioni

Gli avvisi che indicano anteprima pubblica o obsoleto fanno parte dell'output del comando della CLI di Azure e devono essere considerati normali.

La maggior parte dei comandi e dei parametri per un singolo riferimento ha un singolo stato, ma non sempre. Un riferimento GA che viene sviluppato per offrire più comandi può includere comandi di disponibilità 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 TIPO GA Anteprima pubblica Deprecato
az rete dns elenco zone Tutti Nucleo Sì
Creare una zona DNS di rete con az network --name, --resource-group, --if-none-match, --parent-name Nucleo Sì
--existingParameter5 Nucleo Sì
--newParameter6 Nucleo Sì
az network vhub list (elenco vhubs di rete) Tutti Estensione Sì
az network vhub create --address-prefix, --name, --resource-group, -vwan, --location, --sku Estensione Sì
--exsitingParameter7 Estensione Sì
--newParameter8 Estensione Sì
az crea firewall di rete Tutti Estensione Sì

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

Vedere anche