Share via

Snabbstart: Skapa en hanteringsgrupp med REST API

  • Artikel

Hanteringsgrupper är containrar som hjälper dig att hantera åtkomst, principer och efterlevnad i flera prenumerationer. Skapa dessa containrar för att skapa en effektiv och effektiv hierarki som kan användas med Azure Policy och Rollbaserade åtkomstkontroller i Azure. Mer information om hanteringsgrupper finns i Organisera dina resurser med Azure-hanteringsgrupper.

Den första hanteringsgruppen som skapades i katalogen kan ta upp till 15 minuter att slutföra. Det finns processer som körs första gången för att konfigurera hanteringsgruppers tjänst i Azure för din katalog. Du får ett meddelande när processen är klar. Mer information finns i inledande konfiguration av hanteringsgrupper.

Förutsättningar

  • Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.

  • Om du inte redan har gjort det installerar du ARMClient. Det är ett verktyg som skickar HTTP-begäranden till Azure Resource Manager-baserade REST-API:er. I stället kan du använda funktionen "Prova" i REST-dokumentationen eller verktyg som PowerShells Invoke-RestMethod eller Postman.

  • Alla Azure AD-användare i klientorganisationen kan skapa en hanteringsgrupp utan skrivbehörighet för hanteringsgruppen som tilldelats användaren om hierarkiskyddet inte är aktiverat. Den här nya hanteringsgruppen blir underordnad rothanteringsgruppen eller standardhanteringsgruppen och skaparen får rolltilldelningen "Ägare". Med hanteringsgruppstjänsten kan du göra det så att rolltilldelningar inte behövs på rotnivå. Inga användare har åtkomst till rothanteringsgruppen när den skapas. För att undvika hinder för att hitta globala Azure AD-administratörer för att börja använda hanteringsgrupper tillåter vi att de första hanteringsgrupperna skapas på rotnivå.

Azure Cloud Shell

Azure är värd för Azure Cloud Shell, en interaktiv gränssnittsmiljö som du kan använda via webbläsaren. Du kan använda antingen Bash eller PowerShell med Cloud Shell för att arbeta med Azure-tjänster. Du kan använda förinstallerade Cloud Shell-kommandon för att köra koden i den här artikeln, utan att behöva installera något i din lokala miljö.

Så här startar du Azure Cloud Shell:

Alternativ Exempel/länk
Välj Prova i det övre högra hörnet i en kod eller ett kommandoblock. Om du väljer Prova kopieras inte koden eller kommandot automatiskt till Cloud Shell. Screenshot that shows an example of Try It for Azure Cloud Shell.
Gå till https://shell.azure.com eller Välj knappen Starta Cloud Shell för att öppna Cloud Shell i webbläsaren. Button to launch Azure Cloud Shell.
Välj knappen Cloud Shell på menyn längst upp till höger i Azure-portalen. Screenshot that shows the Cloud Shell button in the Azure portal

Så här använder du Azure Cloud Shell:

  1. Starta Cloud Shell.

  2. Välj knappen Kopiera i ett kodblock (eller kommandoblock) för att kopiera koden eller kommandot.

  3. Klistra in koden eller kommandot i Cloud Shell-sessionen genom att välja Ctrl+Skift+V i Windows och Linux, eller genom att välja Cmd+Shift+V på macOS.

  4. Välj Retur för att köra koden eller kommandot.

Skapa i REST API

För REST API använder du hanteringsgrupperna – Skapa eller uppdatera slutpunkten för att skapa en ny hanteringsgrupp. I det här exemplet är hanteringsgruppen groupId Contoso.

  • REST API-URI

    PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/Contoso?api-version=2020-05-01

  • Ingen begärandetext

GroupId är en unik identifierare som skapas. Det här ID:t används av andra kommandon för att referera till den här gruppen och kan inte ändras senare.

Om du vill att hanteringsgruppen ska visa ett annat namn i Azure-portalen lägger du till egenskapen properties.displayName i begärandetexten. Om du till exempel vill skapa en hanteringsgrupp med groupIdför Contoso och visningsnamnet för Contoso Group använder du följande slutpunkt och begärandetext:

  • REST API-URI

    PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/Contoso?api-version=2020-05-01

  • Begärandetext

    {
  "properties": {
    "displayName": "Contoso Group"
  }
}

I föregående exempel skapas den nya hanteringsgruppen under rothanteringsgruppen. Om du vill ange en annan hanteringsgrupp som överordnad använder du egenskapen properties.parent.id .

  • REST API-URI

    PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/Contoso?api-version=2020-05-01

  • Begärandetext

    {
  "properties": {
    "displayName": "Contoso Group",
    "parent": {
      "id": "/providers/Microsoft.Management/managementGroups/HoldingGroup"
    }
  }
}

Rensa resurser

Om du vill ta bort hanteringsgruppen som skapades ovan använder du hanteringsgrupperna – Ta bort slutpunkten:

  • REST API-URI

    DELETE https://management.azure.com/providers/Microsoft.Management/managementGroups/Contoso?api-version=2020-05-01

  • Ingen begärandetext

Nästa steg

I den här snabbstarten skapade du en hanteringsgrupp för att organisera resurshierarkin. Hanteringsgruppen kan innehålla prenumerationer eller andra hanteringsgrupper.

Om du vill veta mer om hanteringsgrupper och hur du hanterar resurshierarkin fortsätter du till:

Hantera resurser med hanteringsgrupper