Översikt: Azure CLI-terminologi och supportnivåer
Den här artikeln beskriver Azure CLI-terminologi. Det finns syntaxkomponenter, referenstyper och statusar. det är statusen som avgör supportnivån.
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 | Kommando | Fullständigt referenskommando | Parameterexempel |
|---|---|---|---|---|---|
| Azure CLI | az config | az config | --local, --output -o | ||
| Azure-nätverk | az network | program-gateway | skapa | az network application-gateway create | --name, --resource-group, --capacity |
| Azure DevOps | az pipelines | agent | list | 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 | Kommando |
|---|---|---|---|---|
| network | program-gateway | private-link | ip-config | add |
En fullständig lista över referenskommandon finns i Referenslista A till Ö .
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 avgör versionsschema, status och installationsmetod enligt beskrivningen här:
| Period | Kärna | Filnamnstillägg |
|---|---|---|
| Referenser | Ingår i den primära Azure CLI-tjänsten | Är valfria referenskommandon som måste installeras |
| 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 allmänt tillgänglig (allmänt tillgänglig), förhandsversion eller experimentell | Kan också vara allmän tillgänglighet, förhandsversion eller experimentell |
Om du vill hämta en lista över kommandogrupper kör du az. Använd az extension list-available --output table-kommandon för en lista över tillägg.
# 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 huvudreferenser alltid uppdaterade.
Filnamnstillägg
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. Här 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 experimentell. Det är referenskommandostatus (inte typ) som bestämmer stabilitets- och supportnivå.
| Allmän tillgänglighet (GA) | Offentlig förhandsversion | Experimentell | |
|---|---|---|---|
| Stabilitet | Permanent | Kan ändras som svar på kundfeedback. Omfattas av villkoren i Förhandsversioner av Microsoft Azure. | Kan ändras som svar på kundfeedback. Migreras ofta till offentlig förhandsversion. Kan tas bort. |
| Supportnivå | Fullständig | Delvis | Ingen |
Anteckning
Varningar som anger offentlig förhandsversion eller experimentell ä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 kommandon för allmän tillgänglighet, förhandsversion och experimentell referens. 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 status:
| Fullständigt referenskommando | Parametrar | Typ | Allmän tillgänglighet (GA) | Offentlig förhandsversion | Experimentell |
|---|---|---|---|---|---|
| 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 | ||
| --newFutureParameter1 | Kärna | ja | |||
| --newFutureParameter2 | Kärna | ja | |||
| az network vhub list | Alla | Filnamnstillägg | ja | ||
| az network vhub create | --address-prefix, --name, --resource-group, -vwan, --location, --sku | Filnamnstillägg | ja | ||
| --newFutureParameter1 | Filnamnstillägg | ja | |||
| --newFutureParameter2 | Filnamnstillägg | ja | |||
| az network firewall create | Alla | Filnamnstillägg | ja |
Tabellen ovan är bara ett exempel och är inte representativ för aktuell referensstatus för exempel.