Přehled: Terminologie Azure CLI a úrovně podpory
Tento článek vysvětluje terminologie Azure CLI. Existují syntaktické komponenty, odkazové typy a stavy. je to stav, který určuje úroveň podpory.
Komponenty syntaxe Azure CLI
Syntaxe Azure CLI je kombinací skupin, odkazů, příkazů a parametrů. Příkaz úplného odkazu se často označuje jako příkaz.
Služba Azure | Referenční skupina | Referenční podskupiny | Příkaz | Příkaz Úplný odkaz | Příklady parametrů |
---|---|---|---|---|---|
Azure CLI | az config | az config | --local, --output -o | ||
Síť Azure | az network | application-gateway | vytvoření | 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říkladaz network application-gateway private-link ip-config add
Referenční skupina | Podskupina 1 | Podskupina 2 | Podskupina 3 | Příkaz |
---|---|---|---|---|
network | 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 tady:
Období | Jádro | Rozšíření |
---|---|---|
Reference | Jsou součástí primární služby Azure CLI. | Jsou volitelné referenční příkazy, které je potřeba nainstalovat? |
Instalace | Společně s instalačním programem MSI | Jednotlivě pomocí příkazu az extension add |
Vydáno | Podle plánu | Jakmile budou k dispozici nové funkce nebo aktualizace |
Stav | Může být obecně dostupné, preview nebo experimentální. | Může to být také GA, Preview nebo experimentální. |
Pokud chcete získat seznam skupin příkazů, spusťte příkaz az
. Pro seznam rozšíření použijte příkazy az extension list-available --output table .
# Get list of all command groups
az
# Get list of extensions
az extension list-available --output table
Jádro
Odkazy Azure CLI, které byly publikovány jako trvalá součást rozhraní příkazového řádku, se nazývají základní odkazy. Všechny základní odkazy se nainstalují pomocí Azure CLI a nemůžete zvolit podmnožinu odkazů. Pokud rozhraní příkazového řádku spouštíte přes Azure Cloud Shell, budou základní odkazy vždy aktuální.
Rozšíření
Rozšíření se nedoručují jako součást rozhraní příkazového řádku, ale spouští se jako příkazy rozhraní příkazového řádku. Některá rozšíření jsou trvalou součástí Azure CLI, ale rozšíření vám často poskytuje přístup k příkazům ve verzi Preview a experimentálním příkazům. Jedna referenční skupina, například az iot hub, může obsahovat příkazy core i extension. Tady jsou dva příklady:
Příkaz Úplný odkaz | Je základní | Je rozšíření |
---|---|---|
az iot hub list | ano | |
az iot hub job list | ano |
Při prvním použití se zobrazí výzva k instalaci rozšíření. Rozšíření můžete také nainstalovat 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: obecně dostupné verze Ga (Obecně dostupné), Verze Public Preview nebo experimentální. Je to stav referenčního příkazu (ne typ), který určuje stabilitu a úroveň podpory.
GA | Verze Public Preview | Experimentální | |
---|---|---|---|
Stability | Trvale | Může se změnit v reakci na zpětnou vazbu od zákazníků. Podléhá podmínkám Microsoft Azure Preview. | Může se změnit v reakci na zpětnou vazbu od zákazníků. Často se migruje na verzi Public Preview. Lze odebrat. |
Úroveň podpory | Do bloku | Částečné | Žádné |
Poznámka
Upozornění označující verzi Public Preview nebo experimentální jsou součástí výstupu příkazu Azure CLI a měli byste je očekávat.
Většina příkazů a parametrů pro jeden odkaz má jeden stav, ale ne vždy. Referenční informace ga, které se vytvářejí tak, aby nabízely více příkazů, můžou obsahovat obecně dostupné příkazy, příkazy preview a experimentální referenční příkazy. Při přidání nových parametrů pro zvýšení funkčnosti může mít jeden příkaz také parametry, které spadají do různých kategorií stavu. Tady jsou ukázkové odkazy, které mají různé stavy:
Příkaz Úplný odkaz | Parametry | Typ | GA | Verze Public Preview | Experimentální |
---|---|---|---|---|---|
az network dns zone list | Vše | Jádro | ano | ||
az network dns zone create | --name, --resource-group, --if-none-match, --parent-name | Jádro | ano | ||
--newFutureParameter1 | Jádro | ano | |||
--newFutureParameter2 | Jádro | ano | |||
az network vhub list | Vše | Rozšíření | ano | ||
az network vhub create | --address-prefix, --name, --resource-group, -vwan, --location, --sku | Rozšíření | ano | ||
--newFutureParameter1 | Rozšíření | ano | |||
--newFutureParameter2 | Rozšíření | ano | |||
az network firewall create | Vše | Rozšíření | ano |
Výše uvedená tabulka je pouze příkladem a v příkladech nereprezentuje aktuální stav odkazu.