Overzicht: Azure CLI-referentietypen en -status
De Azure CLI heeft verschillende referentietypen, die soms door elkaar worden beschreven met de referentiestatus. In dit artikel wordt het verschil tussen een Azure CLI-type en een status uitgelegd en vindt u informatie over het werken met beide.
Azure CLI-syntaxisonderdelen
De Azure CLI-syntaxis is een combinatie van verwijzingen, opdrachten en parameters. De volledige referentieopdracht wordt vaak opdracht genoemd.
| Azure-service | Referentie | Referentiesubservice | Opdracht | Opdracht voor volledige verwijzing | 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 Server | az pipelines | agent | list | az pipelines agent list | --pool-id, --agent-name, --demands |
Wat zijn verwijzingstypen?
Een verwijzingstype geeft aan of de referentieopdracht deel uitmaakt van de primaire Azure CLI-service, of dat het een optionele invoeg-on is. Er zijn twee typen Azure CLI-referentieopdrachten: core en extensie.
| Kern | Extensie | |
|---|---|---|
| Referenties | Maken deel uit van de primaire Azure CLI-service | Zijn optionele referentieopdrachten die moeten worden geïnstalleerd |
| Installeren | Samenwerken met het MSI-installatieprogramma | Afzonderlijk met az extension add |
| Vrijgegeven | Volgens een schema | Zodra er nieuwe functies of updates beschikbaar komen |
| Status | Kan ga (algemeen beschikbaar), preview of experimenteel zijn | Kan ook ga, preview of experimenteel zijn |
Alle Azure CLI-verwijzingen kunnen worden uitgevoerd in Windows, macOS, Linux, Docker en Azure Cloud Shell.
Kern
Azure CLI-verwijzingen die zijn gepubliceerd als een permanent onderdeel van de CLI worden kernverwijzingen genoemd. Alle kernverwijzingen worden geïnstalleerd met de Azure CLI en u kunt geen subset van verwijzingen kiezen. Als u de CLI via Azure Cloud Shell, zijn de kernverwijzingen altijd up-to-date. Zie Core-referentielijst voor de Azure CLI voor een volledige lijst met kernverwijzingsopdrachten.
Extensie
Extensies worden niet verzonden als onderdeel van de CLI, maar worden uitgevoerd als CLI-opdrachten. Sommige extensies zijn een permanent onderdeel van de Azure CLI, maar vaak biedt een extensie u toegang tot privépreviews en experimentele opdrachten. Eén verwijzing, zoals az iot hub, kan zowel kernopdrachten als extensieopdrachten bevatten. Hier zijn vier voorbeelden:
| Opdracht voor volledige verwijzing | Is Core | Is extensie |
|---|---|---|
| az iot hub list | ja | |
| az iot hub query | ja | |
| az iot hub certificate create | ja | |
| az iot hub device identify create | ja |
Belangrijk
U moet een extensie installeren voordat u deze kunt gebruiken door de opdracht az extension add uit te voeren.
Meer informatie over extensieverwijzingen, waaronder installatie en bijwerken, vindt u in Extensies gebruiken met de Azure CLI. Zie Beschikbare extensies voor de Azure CLI voor een volledige lijst met extensieverwijzingsopdrachten.
Wat is referentiestatus?
Ongeacht het type kunnen Azure CLI-verwijzingen worden onderverdeeld in drie statuscategorieën: GA (algemeen beschikbaar), openbare preview of experimenteel. Het is de referentieopdrachtstatus, niet het type, die het stabiliteits- en ondersteuningsniveau bepaalt.
| Algemene beschikbaarheid | Openbare preview | Experimenteel | |
|---|---|---|---|
| Stabiliteit | Permanent | Kan worden gewijzigd als reactie op feedback van klanten. Is onderhevig aan de voorwaarden van Microsoft Azure Previews. | Kan worden gewijzigd als reactie op feedback van klanten. Wordt vaak gemigreerd naar openbare preview. Kan worden verwijderd. |
| Ondersteuningsniveau | Volledig | Gedeeltelijk | Geen |
Hoewel de meeste opdrachten en parameters voor één verwijzing één status hebben, is dit niet altijd het geval. Een ga-verwijzing die wordt ontwikkeld om meer opdrachten te bieden, kan ga-, preview- en experimentele referentieopdrachten bevatten. Als er nieuwe parameters worden toegevoegd om de functionaliteit te vergroten, kan één opdracht ook parameters hebben die onder verschillende statuscategorieën vallen. Hier volgen voorbeeldverwijzingen met verschillende statussen:
| Opdracht voor volledige verwijzing | Parameters | Type | Algemene beschikbaarheid | Openbare preview | Experimenteel |
|---|---|---|---|---|---|
| az network dns zone list | Alles | Kern | ja | ||
| az network dns zone create | --name, --resource-group, --if-none-match, --parent-name | Kern | ja | ||
| --newFutureParameter1 | Kern | ja | |||
| --newFutureParameter2 | Kern | ja | |||
| az network vhub list | Alles | Extensie | ja | ||
| az network vhub create | --address-prefix, --name, --resource-group, -vwan, --location, --sku | Extensie | ja | ||
| --newFutureParameter1 | Extensie | ja | |||
| --newFutureParameter2 | Extensie | ja | |||
| az network firewall create | Alles | Extensie | ja |
Notitie
Waarschuwingen die een openbare preview of experimenteel aangeven, maken deel uit van de uitvoer van de Azure CLI-opdracht en moeten worden verwacht.