Delen via

Overzicht: Azure CLI-terminologie en ondersteuningsniveaus

  • Artikel

In dit artikel worden Azure CLI-terminologie uitgelegd. Er zijn syntaxisonderdelen, verwijzingstypen en statussen.

Azure CLI-syntaxisonderdelen

De Azure CLI-syntaxis is een combinatie van groepen, verwijzingen, opdrachten en parameters. Vaak wordt de volledige verwijzingsopdracht aangeduid als opdracht.

Azure-service Referentiegroep Verwijzingssubgroep(en) Opdracht Volledige naslagopdracht Parametervoorbeelden
Azure-CLI az config az config --local, --output -o
Azure-netwerk az network application-gateway maken az network application-gateway create --name, --resource-group, --capacity
Azure DevOps az pipelines agent lijst az pipelines agent list --pool-id, --agent-name, --demands

Een verwijzingssubgroep kan meerdere niveaus hebben, zoals az network application-gateway private-link ip-config add

Referentiegroep Subgroep 1 Subgroep 2 Subgroep 3 Opdracht
network application-gateway private-link ip-config add

Zie Referentielijst A tot Z voor een volledige lijst met referentieopdrachten.

Wat is referentietype?

Azure CLI-opdrachten maken deel uit van de Azure CLI-kernservice of ze zijn een extensie. Extensies zijn optionele invoegtoepassingen. Het referentietype bepaalt het releaseschema, de status en de installatiemethode, zoals hier wordt beschreven:

Term Basis Toestel
Naslaginformatie Maakt deel uit van de primaire Azure CLI-service Zijn optionele referentieopdrachten die moeten worden geïnstalleerd
Installeren Gezamenlijk met het MSI-installatieprogramma Afzonderlijk met az extension add
Vrijgegeven Volgens een schema Naarmate er nieuwe functies of updates beschikbaar komen
-Status Kan algemeen beschikbaar zijn( algemeen beschikbaar), preview of afgeschaft Kan ook algemeen beschikbaar zijn, preview of afgeschaft

Voer uit azom een lijst met opdrachtgroepen op te halen. Gebruik az extension list-available --output table commands voor een lijst met extensies.

# Get list of all command groups
az

# Get list of extensions
az extension list-available --output table

Basis

Azure CLI-verwijzingen die zijn gepubliceerd als een permanent deel van de CLI, worden kernverwijzingen genoemd. Alle kernverwijzingen worden geïnstalleerd met de Azure CLI en u kunt geen subset met verwijzingen kiezen. Als u de CLI uitvoert via Azure Cloud Shell, zijn kernverwijzingen altijd up-to-date.

Toestel

Extensies worden niet geleverd als onderdeel van de CLI, maar worden uitgevoerd als CLI-opdrachten. Sommige extensies vormen een permanent onderdeel van de Azure CLI, maar vaak biedt een extensie u toegang tot preview- en experimentele opdrachten. Eén referentiegroep, zoals az iot hub, kan zowel kern- als extensieopdrachten hebben. Hieronder vindt u twee voorbeelden:

Volledige naslagopdracht Is kern Is extensie
az iot hub list ja
az iot hub job list ja

U wordt gevraagd om een extensie te installeren wanneer u deze voor het eerst gebruikt. U kunt ook een extensie installeren door de opdracht az extension add uit te voeren.

Meer informatie over extensieverwijzingen, waaronder installatie en bijwerken in Use-extensies met de Azure CLI. Zie Beschikbare extensies voor de Azure CLI voor een volledige lijst met extensieverwijzingsopdrachten.

Wat is de referentiestatus?

Ongeacht het referentietype vallen Azure CLI-verwijzingen in drie statuscategorieën: GA (algemeen beschikbaar), openbare preview of afgeschaft. Dit is de referentieopdrachtstatus (niet het type) die de stabiliteit bepaalt.

GA Openbare preview Afgeschaft
Stabiliteit Permanent Kan veranderen in reactie op feedback van klanten. Is onderhevig aan de voorwaarden van Microsoft Azure Previews. Wordt verwijderd.

Notitie

Waarschuwingen die aangeven dat openbare preview of afgeschaft zijn, maken deel uit van de uitvoer van de Azure CLI-opdracht en moeten worden verwacht.

De meeste opdrachten en parameters voor één verwijzing hebben één status, maar niet altijd. Een GA-verwijzing die is gebouwd om meer opdrachten te bieden, kan zowel ga- als preview-verwijzingsopdrachten bevatten. Wanneer er nieuwe parameters worden toegevoegd om de functionaliteit te vergroten, kan één opdracht ook parameters bevatten die onder verschillende statuscategorieën vallen. Hier volgen voorbeeldverwijzingen met verschillende statussen:

Volledige naslagopdracht Parameters Type GA Openbare preview Afgeschaft
az network dns zone list Alle Basis ja
az network dns zone create --name, --resource-group, --if-none-match, --parent-name Basis ja
--existingParameter5 Basis ja
--newParameter6 Basis ja
az network vhub list Alle 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 Alle Extension ja

De bovenstaande tabel is slechts een voorbeeld en is niet representatief voor de huidige referentiestatussen voor az network.

Zie ook