Áttekintés: Az Azure CLI terminológiája és támogatási szintjei

Ez a cikk az Azure CLI-terminológiát ismerteti. Vannak szintaxisösszetevők, hivatkozástípusok és állapotok.

Az Azure CLI szintaxisösszetevői

Az Azure CLI szintaxisa csoportok, hivatkozások, parancsok és paraméterek kombinációja. A teljes hivatkozási parancsot gyakran parancsnak is nevezik.

Azure-szolgáltatás	Referenciacsoport	Referencia alcsoport	Command	Teljes hivatkozási parancs	Paraméter példák
Azure CLI	az config			az config	\, \, \
Azure Network	az network	application-gateway	létrehoz	az network application-gateway create	\, \, \
Azure DevOps	az pipeline-ok	ügynök	list	az pipelines agent list	\, \, \

A referencia alcsoport több szinttel is rendelkezhet, például az network application-gateway private-link ip-config add.

Referenciacsoport	1. alcsoport	2. alcsoport	3. alcsoport	Command
hálózat	application-gateway	private-link	ip-config	add

A referenciaparancsok teljes listáját az A–Z referencialista tartalmazza.

Mi az a referenciatípus?

Az Azure CLI-parancsok vagy az alapvető Azure CLI-szolgáltatás részei, vagy bővítmények. A bővítmények opcionális bővítmények. A referenciatípus az itt ismertetett kiadási ütemezést, állapotot és telepítési módszert határozza meg:

Term	Core	Extension
References	Az elsődleges Azure CLI szolgáltatás része	Választható referenciaparancsok, amelyeket telepíteni lehet
Install	Az MSI-telepítővel közösen	Külön-külön az extension add
Released	Ütemezés szerint	Új funkciók vagy frissítések elérhetővé válása
Status	Lehet GA (általánosan elérhető), előzetes vagy elavult verzió.	Lehet még GA, előzetes verzió vagy elavult is

A parancscsoportok listájának lekéréséhez futtassa a parancsokat az.

# Get list of all command groups
az

A bővítmények listájához használja az extension list-available --output table a parancsokat.

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

Core

Az Azure CLI állandó részeként közzétett Azure CLI-hivatkozásokat alaphivatkozásnak nevezzük. Minden alapvető hivatkozás az Azure CLI-vel települ, és nem választhatja ki a hivatkozások részhalmazát. Ha az Azure CLI-t az Azure Cloud Shellen keresztül futtatja, az alapvető hivatkozások mindig naprakészek.

Extension

A bővítmények nem az Azure CLI részeként lesznek szállítva, hanem Azure CLI-parancsokként futnak. Egyes bővítmények az Azure CLI állandó részét képezik, de a bővítmények gyakran hozzáférést biztosítanak az előzetes és a kísérleti parancsokhoz. Egyetlen referenciacsoporthoz, például az iot hubaz alap- és bővítményparancsokhoz is tartozhat. Bemutatunk két példát:

Teljes hivatkozási parancs	Alapvető modul	Bővítmény
az iot hub lista	yes
az IoT hub feladatlistája		yes

A rendszer arra kéri, hogy első használatkor telepítsen egy bővítményt. A bővítményt az az extension add parancs futtatásával is telepítheti.

További információt a bővítményhivatkozásokról, beleértve a telepítést és a frissítést, a Bővítmények használata az Azure CLI-vel című részben találhat. A bővítmény-referenciaparancsok teljes listáját az Azure CLI elérhető bővítményei között találja.

Mi a hivatkozás állapota?

A referenciatípustól függetlenül az Azure CLI-hivatkozások három állapotkategóriába sorolhatók: ga (általánosan elérhető), nyilvános előzetes verzió vagy elavult. Ez a referenciaparancs állapota (nem típus), amely meghatározza a stabilitást.

	GA	Nyilvános előzetes verzió	Deprecated
Stability	Permanent	Az ügyfél visszajelzésére reagálva változhat. A Microsoft Azure Previews feltételei érvényesek.	Eltávolításra kerül.

Note

A nyilvános előzetes verziót vagy az elavultságot jelző figyelmeztetések az Azure CLI parancs kimenetének részét képezik, és elvárásnak kell lenniük.

Az egyetlen hivatkozás legtöbb parancsa és paramétere egyetlen állapotú, de nem mindig ez a helyzet. A GA-referencia, amelyet éppen bővítenek több parancs hozzáadásával, tartalmazhat mind GA, mind előzetes verzió hivatkozási parancsokat. Mivel új paramétereket adnak hozzá a funkciók növeléséhez, egyetlen parancs is rendelkezhet olyan paraméterekkel, amelyek különböző állapotkategóriákba tartoznak. Az alábbi példahivatkozások különböző állapotúak:

Teljes hivatkozási parancs	Parameters	Típus	GA	Nyilvános előzetes verzió	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

Az előző táblázat csak egy példa, és nem a jelenlegi referenciaállapotokat az networkjelöli.

Lásd még

• Az Azure CLI támogatási életciklusa