Översikt: Azure CLI-terminologi och supportnivåer
I den här artikeln beskrivs Azure CLI-terminologi. Det finns syntaxkomponenter, referenstyper och statusar.
Azure CLI-syntaxkomponenter
Azure CLI-syntaxen är en kombination av grupper, referenser, kommandon och parametrar. Ofta kallas det fullständiga referenskommandot för kommando.
| Azure-tjänst | Referensgrupp | Referensundergrupper | Command | Fullständigt referenskommando | Parameterexempel |
|---|---|---|---|---|---|
| Azure CLI | az config | az config | --local, --output -o | ||
| Azure-nätverk | az network | application-gateway | skapa | az network application-gateway create | --name, --resource-group, --capacity |
| Azure DevOps | az pipelines | agent | lista | az pipelines agent list | --pool-id, --agent-name, --demands |
En referensundergrupp kan ha flera nivåer, till exempel az network application-gateway private-link ip-config add
| Referensgrupp | Undergrupp 1 | Undergrupp 2 | Undergrupp 3 | Command |
|---|---|---|---|---|
| network | application-gateway | private-link | ip-config | add |
En fullständig lista över referenskommandon finns i Referenslista A till Z .
Vad är referenstyp?
Azure CLI-kommandon är antingen en del av azure CLI-kärntjänsten , eller så är de ett tillägg. Tillägg är valfria tillägg. Referenstypen bestämmer versionsschemat, statusen och installationsmetoden enligt beskrivningen här:
| Period | Kärna | Anknytning |
|---|---|---|
| Referenser | Ingår i den primära Azure CLI-tjänsten | Är valfria referenskommandon som måste installeras |
| Install (Installera) | Tillsammans med MSI-installationsprogrammet | Individuellt med az extension add |
| Släppt | Enligt ett schema | När nya funktioner eller uppdateringar blir tillgängliga |
| Status | Kan vara GA (allmänt tillgänglig), förhandsversion eller inaktuell | Kan också vara GA, förhandsversion eller inaktuell |
Om du vill hämta en lista över kommandogrupper kör du az. För en lista över tillägg använder du az extension list-available --output table commands.
# Get list of all command groups
az
# Get list of extensions
az extension list-available --output table
Kärna
Azure CLI-referenser som har publicerats som en permanent del av CLI kallas för kärnreferenser. Alla kärnreferenser installeras med Azure CLI och du kan inte välja en delmängd referenser. Om du kör CLI via Azure Cloud Shell är huvudreferenserna alltid uppdaterade.
Anknytning
Tillägg levereras inte som en del av CLI utan körs som CLI-kommandon. Vissa tillägg är en permanent del av Azure CLI, men ofta ger ett tillägg dig åtkomst till förhandsversioner och experimentella kommandon. En enda referensgrupp, till exempel az iot hub, kan ha både kärn- och tilläggskommandon. Nedan följer två exempel:
| Fullständigt referenskommando | Is Core | Är tillägg |
|---|---|---|
| az iot hub list | ja | |
| az iot hub job list | ja |
Du uppmanas att installera ett tillägg vid första användningen. Du kan också installera ett tillägg genom att köra kommandot az extension add .
Du kan lära dig mer om tilläggsreferenser, inklusive installation och uppdatering i Använda tillägg med Azure CLI. En fullständig lista över tilläggsreferenskommandon finns i Tillgängliga tillägg för Azure CLI .
Vad är referensstatus?
Oavsett referenstyp finns Azure CLI-referenser i tre statuskategorier: GA (allmänt tillgänglig), offentlig förhandsversion eller inaktuell. Det är referenskommandostatusen (inte typen) som avgör stabiliteten.
| Allmän tillgänglighet | Offentlig förhandsversion | Inaktuell | |
|---|---|---|---|
| Stabilitet | Permanent | Kan ändras som svar på kundfeedback. Omfattas av villkoren i Förhandsversioner av Microsoft Azure. | Kommer att tas bort. |
Kommentar
Varningar som anger offentlig förhandsversion eller inaktuell är en del av Azure CLI-kommandoutdata och bör förväntas.
De flesta kommandon och parametrar för en enda referens har en enda status, men inte alltid. En GA-referens som håller på att byggas ut för att erbjuda fler kommandon kan ha referenskommandon för både GA och förhandsversion. När nya parametrar läggs till för att öka funktionaliteten kan ett enda kommando också ha parametrar som faller under olika statuskategorier. Här är exempelreferenser som har olika statusar:
| Fullständigt referenskommando | Parametrar | Typ | Allmän tillgänglighet | Offentlig förhandsversion | Inaktuell |
|---|---|---|---|---|---|
| az network dns zone list | Alla | Kärna | ja | ||
| az network dns zone create | --name, --resource-group, --if-none-match, --parent-name | Kärna | ja | ||
| --existingParameter5 | Kärna | ja | |||
| --newParameter6 | Kärna | ja | |||
| az network vhub list | Alla | Extension | ja | ||
| az network vhub create | --address-prefix, --name, --resource-group, -vwan, --location, --sku | Extension | ja | ||
| --exsitingParameter7 | Extension | ja | |||
| --newParameter8 | Extension | ja | |||
| az network firewall create | Alla | Extension | ja |
Tabellen ovan är bara ett exempel och är inte representativ för de aktuella referensstatusarna för az network.
