Overzicht: Azure CLI-terminologie en ondersteuningsniveaus
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.
