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 waarmee u te maken hebt in Azure.

Met de Azure-opdrachtregelinterface (CLI) kunt u standaardResourcegroepen maken, behouden en instellen. Met de CLI kunt u ook resources opschonen nadat u ze hebt gemaakt.

Identificatie van Azure-regio's

Azure-klanten kunnen ervoor kiezen om resources in veel verschillende regio's te implementeren. In sommige gevallen kunnen klanten de kosten verlagen door regio's in de buurt te selecteren die dezelfde services aanbieden. Als er een regio in de buurt wordt geïdentificeerd, wordt in een bericht de regio weergegeven die moet worden geselecteerd voor toekomstige implementaties.

In het volgende voorbeeld wordt de az config opdracht gebruikt om het bericht over regioaanbevelen uit te schakelen:

az config set core.display_region_identified=no

Zie De juiste Azure-regio voor u kiezen voor meer informatie over Azure-regio's.

Een brongroep 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. Als u alle locaties wilt zien die worden ondersteund in uw huidige abonnement, voert u de opdracht az account list-locations uit:

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 beschrijvende 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

Als u een resourcegroep wilt verwijderen, voert u de opdracht az group delete uit:

az group delete --name MyResourceGroup

Wanneer u een resourcegroep verwijdert, verwijdert u alle resources waartoe deze behoort. U kunt deze actie niet ongedaan maken. Als u een van de opdrachten in dit artikel probeert, verwijdert u de resourcegroepen die u maakt, uw account opschonen.

Een standaardresourcegroep instellen

U kunt een standaardresourcegroep instellen voor alle opdrachten die u uitvoert vanuit uw lokale Azure CLI of vanuit 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.

Als u een standaardresourcegroep wilt instellen voor uw Azure CLI-installatie, voert u de opdracht az config set uit:

az config set defaults.group=MyResourceGroup

Met de opdracht wordt een waarde voor een opgegeven sleutel ingesteld, in dit geval defaults.group. Zie De Azure CLI-configuratie voor beschikbare configuratieopties.

Notitie

De opdracht az config set valideert niet het bestaan van de resourcegroep die u invoert. Met de opdracht wordt het sleutel-waardepaar opgeslagen.

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 werkt. Als de standaardwaarde van een resourcegroep niet bij uw huidige abonnement hoort, treedt er een fout op. Zie 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 Azure Portal aanbrengt.

Als u permanente parameterwaarden gebruikt, zoals beschreven in dit artikel, hebben deze waarden voorrang op standaardwaarden die zijn ingesteld in het configuratiebestand .

Een resourcegroepvergrendeling instellen

Als beheerder moet u mogelijk een resourcegroep vergrendelen om te voorkomen dat gebruikers deze verwijderen of wijzigen. Zie Resources vergrendelen om onverwachte wijzigingen te voorkomen voor meer informatie.

Gebruik in Azure CLI de opdrachten az group lock . De opdracht az account lock create kan bijvoorbeeld voorkomen dat gebruikers een resourcegroep verwijderen:

az group lock create --name "Cannot delete resource group" --lock-type CanNotDelete

Notitie

U moet machtigingen hebben contributor voor een resourcegroep om vergrendelingen te maken of te wijzigen.

Als u de huidige vergrendelingen voor uw resourcegroep wilt zien, gebruikt u de opdracht az group lock list :

az group lock list --output table

Resources opschonen

Als u een van de opdrachten in dit artikel hebt geprobeerd, kunt u alle resources verwijderen die u hebt gemaakt 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.

Zie ook