Dela via

Ö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 Befallning Fullständigt referenskommando Parameterexempel
Azure CLI (kommandoradsgränssnittet för Azure) az config az config --local (lokal), --output -o (utdata -o)
Azure-nätverk az network applikations-gateway skapa az network application-gateway create (skapande av applikationsgateway) --name, --resource-group, --kapacitet
Azure DevOps az pipelines ombud lista az pipelines agentlista --pool-id, --agent-namn, --krav

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 Befallning
nätverk applikations-gateway privat länk IP-konfiguration lägg till

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 extrafunktioner. Referenstypen bestämmer versionsschemat, statusen och installationsmetoden enligt beskrivningen här:

Begrepp Kärna Förlängning
Referenser Ingår i den primära Azure CLI-tjänsten Är valfria referenskommandon som kan installeras om så önskas
Installera Tillsammans med MSI-installationsprogrammet Individuellt med kommandot 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 kommandot az extension list-available --output table.

# 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.

Förlängning

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 Är Kärna Är förlängning
az iot hub list Ja
az iot-hubb-jobblista 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.

GA Offentlig förhandsversion Avrådes från användning
Stabilitet Permanent Kan ändras som svar på kundfeedback. Omfattas av villkoren i Förhandsversioner av Microsoft Azure. Kommer att tas bort.

Anmärkning

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 Parameterar Typ GA Offentlig förhandsversion Avrådes från användning
az network dns zone list Allt Kärna Ja
az network dns zone skapa (skapar en ny DNS-zon) --name (namn), --resource-group (resursgrupp), --if-none-match (om-inget-match), --parent-name (föräldernamn) Kärna Ja
--existingParameter5 Kärna Ja
--newParameter6 Kärna Ja
az network vhub list Allt Förlängning Ja
az network vhub create --address-prefix, --name, --resource-group, -vwan, --location, --sku Förlängning Ja
--existingParameter7 Förlängning Ja
--newParameter8 Förlängning Ja
az nätverksbrandvägg skapa Allt Förlängning Ja

Tabellen ovan är bara ett exempel och är inte representativ för de aktuella referensstatusarna för az network.

Se även