Á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 nevezik.
| Azure-szolgáltatás | Referenciacsoport | Referencia alcsoport(ok) | Parancs | Teljes hivatkozási parancs | Példák paraméterre |
|---|---|---|---|---|---|
| Azure CLI | az config | az config | --local, --output -o | ||
| Azure-hálózat | az network | application-gateway | létrehozás | az network application-gateway create | --name, --resource-group, --capacity |
| Azure DevOps | az pipelines | ügynök | list | az pipelines agent list | --pool-id, --agent-name, --demands |
A referencia-alcsoportok több szinttel is rendelkezhetnek, például az network application-gateway private-link ip-config add
| Referenciacsoport | 1. alcsoport | 2. alcsoport | 3. alcsoport | Parancs |
|---|---|---|---|---|
| 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 leírt kiadási ütemezést, állapotot és telepítési módszert határozza meg:
| Időszak | Alapvető | Mellék |
|---|---|---|
| Hivatkozások | Az elsődleges Azure CLI szolgáltatás része | Nem kötelező referenciaparancsok, amelyeket telepíteni kell |
| Telepítés | Az MSI-telepítővel közösen | Egyénileg az az extension add |
| Mentesít | Ütemezés szerint | Új funkciók vagy frissítések elérhetővé válása |
| Állapot | Lehet ga (általánosan elérhető), előzetes verzió vagy elavult | A ga, az előzetes verzió vagy az elavult is lehet |
A parancscsoportok listájának lekéréséhez futtassa a parancsokat az. A bővítmények listájához használja az az extension list-available --output table parancsokat.
# Get list of all command groups
az
# Get list of extensions
az extension list-available --output table
Alapvető
A parancssori felület állandó részeként közzétett Azure CLI-hivatkozásokat alaphivatkozásoknak nevezzük. Az összes alapvető hivatkozás az Azure CLI-vel települ, és nem választhatja ki a hivatkozások részhalmazát. Ha az Azure Cloud Shellen keresztül futtatja a parancssori felületet, az alapvető hivatkozások mindig naprakészek.
Mellék
A bővítmények nem a parancssori felület részeként, hanem parancssori felületi 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 referenciacsoport, például az iot hub, mag- és bővítményparancsokkal is rendelkezhet. Bemutatunk két példát:
| Teljes hivatkozási parancs | Is Core | Bővítmény |
|---|---|---|
| az iot hub list | igen | |
| az iot hub job list | igen |
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ó a bővítményhivatkozásokról, beleértve a telepítést és a frissítést a Use bővítményekben az Azure CLI-vel. 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.
| FE | Nyilvános előzetes verzió | Elavult | |
|---|---|---|---|
| Stabilitás | Állandó | Az ügyfél visszajelzésére reagálva változhat. A Microsoft Azure Previews feltételei érvényesek. | A rendszer eltávolítja. |
Feljegyzés
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. A ga-referencia, amely több parancsot kínál, ga és előzetes verziójú referenciaparancsokkal is rendelkezhet. 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 | Paraméterek | Típus | FE | Nyilvános előzetes verzió | Elavult |
|---|---|---|---|---|---|
| az network dns zone list | Mind | Alapvető | igen | ||
| az network dns zone create | --name, --resource-group, --if-none-match, --parent-name | Alapvető | igen | ||
| --existingParameter5 | Alapvető | igen | |||
| --newParameter6 | Alapvető | igen | |||
| az network vhub list | Mind | Mellék | igen | ||
| az network vhub create | --address-prefix, --name, --resource-group, -vwan, --location, --sku | Mellék | igen | ||
| --exsitingParameter7 | Mellék | igen | |||
| --newParameter8 | Mellék | igen | |||
| az network firewall create | Mind | Mellék | igen |
A fenti táblázat csak egy példa, és nem reprezentatív a jelenlegi referenciaállapotokra.az network