Přehled: Terminologie Azure CLI a úrovně podpory

Tento článek vysvětluje terminologie Azure CLI. Existují komponenty syntaxe, odkazové typy a stavy.

Komponenty syntaxe Azure CLI

Syntaxe Azure CLI je kombinací skupin, odkazů, příkazů a parametrů. Úplný referenční příkaz se často označuje jako příkaz.

Služba Azure	Referenční skupina	Referenční podskupina	Command	Úplný referenční příkaz	Příklady parametrů
Azure CLI	az config			az config	--local --output, -o
Síť Azure	az network	application-gateway	vytvořit	az network application-gateway create	--name --resource-group, --capacity
Azure DevOps	az pipelines	agent	list	az pipelines agent list	--pool-id --agent-name, --demands

Referenční podskupina může mít více úrovní, například az network application-gateway private-link ip-config add.

Referenční skupina	Podskupina 1	Podskupina 2	Podskupina 3	Command
síť	application-gateway	private-link	ip-config	add

Úplný seznam referenčních příkazů najdete v části Referenční seznam A až Z .

Co je typ odkazu?

Příkazy Azure CLI jsou buď součástí základní služby Azure CLI, nebo jsou rozšířením. Rozšíření jsou volitelné doplňky. Referenční typ určuje plán vydání, stav a metodu instalace, jak je popsáno zde:

Term	Core	Extension
References	Jsou součástí primární služby Azure CLI.	Jsou volitelné referenční příkazy, které je potřeba nainstalovat.
Install	Společně s instalačním programem MSI	Individuálně s az extension add
Released	Podle plánu	Jakmile budou k dispozici nové funkce nebo aktualizace
Status	Může být obecně dostupná, náhledová nebo zastaralá.	Může to být také verze GA, Preview nebo zastaralá.

Seznam skupin příkazů získáte spuštěním azpříkazu .

# Get list of all command groups
az

Pro seznam rozšíření použijte az extension list-available --output table příkazy.

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

Core

Odkazy Azure CLI publikované jako trvalá část Azure CLI se označují jako základní odkazy. Všechny základní odkazy se instalují pomocí Azure CLI a nemůžete zvolit podmnožinu odkazů. Pokud spouštíte Azure CLI prostřednictvím Azure Cloud Shellu, základní odkazy jsou vždy aktuální.

Extension

Rozšíření se nedoručují jako součást Azure CLI, ale běží jako příkazy Azure CLI. Některá rozšíření jsou trvalou součástí Azure CLI, ale často poskytuje rozšíření přístup k náhledům a experimentálním příkazům. Jedna referenční skupina, například az iot hub, může mít základní i rozšiřující příkazy. Zde jsou dva příklady:

Úplný referenční příkaz	Je jádro	Je to rozšíření?
příkaz 'az iot hub list' pro zobrazení IoT hubů	yes
seznam úloh az iot hub		yes

Při prvním použití se zobrazí výzva k instalaci rozšíření. Rozšíření můžete nainstalovat také spuštěním příkazu az extension add .

Další informace o odkazech na rozšíření, včetně instalace a aktualizace, najdete v tématu Použití rozšíření pomocí Azure CLI. Úplný seznam referenčních příkazů rozšíření najdete v tématu Dostupná rozšíření pro Azure CLI .

Co je stav odkazu?

Bez ohledu na typ odkazu spadají odkazy Azure CLI do tří kategorií stavu: ga (obecně dostupné), verze Public Preview nebo zastaralé. Jedná se o stav referenčního příkazu (ne typu), který určuje stabilitu.

	GA	Veřejná ukázka	Deprecated
Stability	Permanent	Může se změnit v reakci na zpětnou vazbu zákazníků. Podléhá podmínkám microsoft Azure Preview.	Bude odstraněno.

Note

Upozornění, která uvádějí, že jde o verzi Public Preview nebo je zastaralé, jsou součástí výstupu příkazu Azure CLI a je třeba je očekávat.

Většina příkazů a parametrů pro jeden odkaz má jediný stav, ale to není vždy případ. Referenční informace GA, které se vytvářejí s cílem nabízet více příkazů, můžou zahrnovat jak příkazy GA, tak příkazy v režimu náhledu. Při přidání nových parametrů ke zvýšení funkčnosti může mít jeden příkaz také parametry, které spadají do různých kategorií stavu. Tady jsou příklady odkazů, které mají různé stavy:

Úplný referenční příkaz	Parameters	Typ	GA	Veřejná ukázka	Deprecated
az network dns zone list	All	Core	yes
az network dns zone create	--name, --resource-group, , --if-none-match--parent-name	Core	yes
	--existingParameter5	Core			yes
	--newParameter6	Core		yes
az network vhub list	All	Extension	yes
az network vhub create	--address-prefix, --name, --resource-group, -vwan, , --location--sku	Extension	yes
	--existingParameter7	Extension		yes
	--newParameter8	Extension	yes
az network firewall create	All	Extension		yes

Předchozí tabulka je pouze příkladem a nepředstavuje aktuální stav odkazu pro az network.

Viz také

• Životní cyklus podpory Azure CLI