Quickstart: Een beheergroep maken met Go

Artikel
10/16/2024

Managementgroepen zijn containers die u helpen bij het beheren van toegang, beleid en naleving voor meerdere abonnementen. Maak deze containers om een doeltreffende en efficiënte hiërarchie te maken die kan worden gebruikt met Azure Policy en op rollen gebaseerd toegangsbeheer van Azure. Zie Uw resources indelen met Azure-beheergroepen voor meer informatie over beheergroepen.

Het kan tot vijftien minuten duren voordat de eerste beheergroep die in de map is gemaakt, is voltooid. Er zijn processen die de eerste keer worden uitgevoerd om de service voor beheergroepen in Azure in te stellen voor uw map. U ontvangt een melding wanneer het proces is voltooid. Zie Eerste configuratie van beheergroepen voor meer informatie.

Vereisten

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
Een Azure-service-principal, met inbegrip van de clientId en clientSecret. Als u geen service-principal hebt voor gebruik met Azure Policy of als u een nieuwe wilt maken, raadpleegt u Azure-beheerbibliotheken voor .NET-verificatie. Sla de stap over om de .NET Core-pakketten te installeren; dit doet u in de volgende stappen.
Elke Microsoft Entra ID-gebruiker in de tenant kan een beheergroep maken zonder de schrijfmachtiging voor de beheergroep die aan die gebruiker is toegewezen als hiërarchiebeveiliging niet is ingeschakeld. Deze nieuwe beheergroep wordt een onderliggend element van de hoofdbeheergroep of de standaardbeheergroep en de maker krijgt een roltoewijzing eigenaar. Met de beheergroep-service kan deze functie worden toegewezen, zodat roltoewijzingen niet nodig zijn op hoofdmapniveau. Wanneer de hoofdbeheergroep wordt gemaakt, hebben gebruikers er geen toegang toe. Als u beheergroepen wilt gaan gebruiken, maakt de service het maken van de eerste beheergroepen op het hoofdniveau mogelijk. Zie Hoofdbeheergroep voor elke map voor meer informatie.

Azure Cloud Shell

Azure host Azure Cloud Shell, een interactieve shell-omgeving die u via uw browser kunt gebruiken. U kunt Bash of PowerShell gebruiken met Cloud Shell om met Azure-services te werken. U kunt de vooraf geïnstalleerde Cloud Shell-opdrachten gebruiken om de code in dit artikel uit te voeren zonder dat u iets hoeft te installeren in uw lokale omgeving.

Om Azure Cloud Shell op te starten:

Optie	Voorbeeld/koppeling
Selecteer Uitproberen in de rechterbovenhoek van een code- of opdrachtblok. Als u Try It selecteert, wordt de code of opdracht niet automatisch gekopieerd naar Cloud Shell.
Ga naar https://shell.azure.com, of selecteer de knop Cloud Shell starten om Cloud Shell in uw browser te openen.
Klik op de knop Cloud Shell in het menu in de balk rechtsboven in de Azure-portal.

Azure Cloud Shell gebruiken:

Start Cloud Shell.
Selecteer de knop Kopiëren op een codeblok (of opdrachtblok) om de code of opdracht te kopiëren.
Plak de code of opdracht in de Cloud Shell-sessie door Ctrl+Shift+V in Windows en Linux te selecteren of door Cmd+Shift+V te selecteren in macOS.
Selecteer Enter om de code of opdracht uit te voeren.

Het beheergroeppakket toevoegen

Als u Go wilt inschakelen voor het beheren van beheergroepen, moet het pakket worden toegevoegd. Dit pakket werkt overal waar Go kan worden gebruikt, inclusief bash in Windows 10 of lokaal geïnstalleerd.

Controleer of de nieuwste Versie is geïnstalleerd (ten minste 1,15). Als deze nog niet is geïnstalleerd, downloadt u deze op Golang.org.
Controleer of de meest recente Azure CLI is geïnstalleerd (minimaal 2.5.1). Als deze nog niet is geïnstalleerd, raadpleegt u De Azure CLI installeren.

Notitie

Azure CLI is vereist om Go in te schakelen voor het gebruik van de auth.NewAuthorizerFromCLI()-methode in het volgende voorbeeld. Zie Azure SDK voor Go - meer verificatiedetails voor informatie over andere opties.
Verifieer via Azure CLI.
```
az login
```

Installeer in uw Go-omgeving de vereiste pakketten voor beheergroepen:

# Add the management group package for Go
go install github.com/Azure/azure-sdk-for-go/services/resources/mgmt/2020-05-01/managementgroups@latest

# Add the Azure auth package for Go
go install github.com/Azure/go-autorest/autorest/azure/auth@latest

Installatie van toepassing

Nu de Go-pakketten zijn toegevoegd aan uw gewenste omgeving, is het tijd om de Go-toepassing in te stellen die een beheergroep kan maken.

Maak de Go-toepassing en sla de volgende bron op als mgCreate.go:

package main

import (
  "context"
  "fmt"
  "os"

  mg "github.com/Azure/azure-sdk-for-go/services/resources/mgmt/2020-05-01/managementgroups"
  "github.com/Azure/go-autorest/autorest/azure/auth"
)

func main() {
  // Get variables from command line arguments
  var mgName = os.Args[1]

  // Create and authorize a client
  mgClient := mg.NewClient()
  authorizer, err := auth.NewAuthorizerFromCLI()
  if err == nil {
    mgClient.Authorizer = authorizer
  } else {
    fmt.Printf(err.Error())
  }

  // Create the request
  Request := mg.CreateManagementGroupRequest{
    Name: &mgName,
  }

  // Run the query and get the results
  var results, queryErr = mgClient.CreateOrUpdate(context.Background(), mgName, Request, "no-cache")
  if queryErr == nil {
    fmt.Printf("Results: " + fmt.Sprint(results) + "\n")
  } else {
    fmt.Printf(queryErr.Error())
  }
}

De Go-toepassing maken:
```
go build mgCreate.go
```
Maak een beheergroep met behulp van de gecompileerde Go-toepassing. Vervang <Name> door de naam van uw nieuwe beheergroep:
```
mgCreate "<Name>"
```

Het resultaat is een nieuwe beheergroep in de hoofdbeheergroep.

Resources opschonen

Als u de geïnstalleerde pakketten uit uw Go-omgeving wilt verwijderen, kunt u dit doen met de volgende opdracht:

# Remove the installed packages from the Go environment
go clean -i github.com/Azure/azure-sdk-for-go/services/resources/mgmt/2020-05-01/managementgroups
go clean -i github.com/Azure/go-autorest/autorest/azure/auth

Volgende stappen

In deze quickstart hebt u een beheergroep gemaakt om uw resource-hiërarchie te organiseren. De beheergroep kan abonnementen of andere beheergroepen bevatten.

Ga verder met het volgende voor meer informatie over beheergroepen en het beheren van uw resource-hiërarchie:

Uw resources beheren met beheergroepen

Delen via