Azure-resourcegroepen beheren met de Azure CLI
Een Azure-resourcegroep is een container met gerelateerde resources voor een Azure-oplossing. Een resourcegroep kan opslag, virtuele machines, apps, dashboards, services of bijna alles bevatten waar u mee te maken hebt in Azure.
Met de Azure Command-Line Interface (CLI) kunt u standaard Azure-resourcegroepen maken, persistent maken en instellen. Met de CLI kunt u ook resources ops schonen nadat u ze hebt aanmaken.
Een resourcegroep maken
U kunt een resourcegroep maken met de opdracht az group create:
az group create --name MyResourceGroup --location eastus
Een resourcegroep behoort tot één locatie. Voer de opdracht az account list-locations uit om alle locaties te zien die worden ondersteund in uw huidige abonnement:
az account list-locations
Als u alle resourcegroepen voor uw huidige abonnement wilt zien, gebruikt u de opdracht az group list:
az group list --output table
Tip
De --output parameter is een globale parameter die beschikbaar is voor alle opdrachten. De tabelwaarde geeft uitvoer weer in een gebruiksvriendelijke indeling. Zie Uitvoerindelingen voor Azure CLI-opdrachten voor meer informatie.
Wanneer u een resource maakt, maakt u deze in een resourcegroep. In het volgende voorbeeld ziet u een opslagaccount dat is gemaakt met behulp van de opdracht az storage account create:
az storage account create --resource-group MyResourceGroup --name storage134 --location eastus --sku Standard_LRS
Voer de opdracht az group delete uit om een resourcegroep te verwijderen:
az group delete --name MyResourceGroup
Wanneer u een resourcegroep verwijdert, verwijdert u alle resources die er deel van uitmaken. Er is geen optie om het gebruik van resources te dedigen. Als u een van de opdrachten in dit artikel probeert uit te voeren, wordt uw account verwijderd door de resourcegroepen te verwijderen die u maakt.
Een resourcegroep persistent maken
Met persistentie van parameters kunt u waarden voor bepaalde parameters opnieuw gebruiken, waaronder resourcegroepen.
Schakel eerst de persistentiefunctie in met behulp van de opdracht az config param-persist on:
az config param-persist on
Maak na het in-/uitschakelen van persistentie nog een resourcegroep:
az group create --name OtherResourceGroup --location eastus
Zolang persistentie is aan, kunt u de --resource-group parameter buiten toekomstige opdrachten laten. Met de volgende opdracht maakt u een opslagaccount in de groep OtherResourceGroup:
az storage account create --name storage135 --location eastus --sku Standard_LRS
Als u een resourcegroep opgeeft in de opdracht , heeft deze prioriteit. Met de volgende opdracht maakt u een opslaggroep in een resourcegroep met de naam StorageGroups:
az storage account create --resource-group StorageGroups --name storage136 --location eastus --sku Standard_LRS
Zodra u een andere resourcegroep als waarde opgeeft, wordt de persistente waarde echter opnieuw ingesteld in Azure CLI. Nieuwe opdrachten gebruiken StorageGroups als de resourcegroep. U kunt de persistente waarden zien met behulp van de opdracht az config param-persist show:
az config param-persist show
Met deze opdracht ziet u de huidige persistente waarden. Deze waarden worden opgeslagen in een bestand met de naam <username> local_context_ in een verborgen map met de naam .azure. Azure CLI maakt de map op uw huidige locatie wanneer u voor het eerst een permanente waarde maakt.
Wanneer u klaar bent met het gebruik van persistente parameters, moet u de opdracht az config param-persist off uitvoeren:
az config param-persist off
Azure CLI slaat uw persistente waarden op. U kunt ze zien in het lokale contextbestand. Als u parameter persistentie opnieuw in te stellen, zijn deze waarden al ingesteld.
Zie Persistente parameters gebruiken om sequentiële Azure CLI-opdrachten tevereenvoudigen voor meer informatie over het gebruik van de opdrachten az config param-persist.
Een standaardresourcegroep instellen
U kunt een standaardresourcegroep instellen voor alle opdrachten die u vanuit uw lokale Azure CLI of vanuit de Azure Cloud Shell. Azure CLI slaat deze configuratie lokaal op in een configuratiebestand. Voer de opdracht az config get uit om uw huidige configuratie te zien:
az config get
Het resultaat bevat standaardresourcegroepen en andere standaardwaarden. Als u Azure CLI voor het eerst gebruikt, zijn de resultaten mogelijk leeg.
Voer de opdracht az config set uit om een standaardresourcegroep in te stellen voor uw Azure CLI-installatie:
az config set defaults.group=MyResourceGroup
Met de opdracht stelt u een waarde in voor een opgegeven sleutel, in dit geval defaults.group . Zie Azure CLI-configuratie voor beschikbare configuratieopties.
Notitie
Met de opdracht az config set wordt het bestaan van de door u invoeren resourcegroep niet gevalideerd. De opdracht slaat gewoon het sleutel-waardepaar op.
Nadat u de opdracht hebt uitgevoerd, krijgt u met de volgende twee opdrachten hetzelfde resultaat:
az storage account create --resource-group MyResourceGroup --name storage01 --location eastus --sku Standard_LRS
az storage account create --name storage01 --location eastus --sku Standard_LRS
Een resourcegroep behoort tot een abonnement. Als uw organisatie meer dan één abonnement heeft, moet u dat abonnement instellen voordat u met een resourcegroep in het abonnement gaat werken. Als de standaardwaarde van een resourcegroep niet bij uw huidige abonnement hoort, wordt er een foutbericht weergegeven. Zie Use multiple Azure subscriptions (Meerdere Azure-abonnementen gebruiken) voor meer informatie over meerdere abonnementen.
U hoeft de standaardinstelling niet opnieuw in te stellen om andere resourcegroepen te gebruiken. Geef in plaats daarvan de resourcegroep op:
az group create --name OtherResourceGroup --location eastus
az storage account create --resource-group StorageGroups --name storage03 --location westus --sku Standard_LRS
De standaardwaarde is alleen voor u. Dit heeft geen invloed op andere gebruikers of wijzigingen die u via de Azure Portal.
Als u persistente parameterwaarden gebruikt, zoals beschreven in dit artikel, hebben deze waarden voorrang op de standaardwaarden die zijn ingesteld in het configuratiebestand.
Resources opschonen
Als u een van de opdrachten in dit artikel hebt geprobeerd, kunt u alle resources die u hebt gemaakt, verwijderen met behulp van de opdracht az group delete:
az group delete --name MyResourceGroup
az group delete --name OtherResourceGroup
az group delete --name StorageGroups
Met deze opdracht verwijdert u de groep en alle resources die deze in één keer bevat.
U kunt de permanente parameters verwijderen door de opdracht az config param-persist delete uit te voeren:
az config param-persist delete --all
Zie ook
Zelfstudie: Persistente parameters gebruiken om sequentiële Azure CLI-opdrachten te vereenvoudigen