Hierarchy Settings - Create Or Update

Tjänst:

Management Groups

API-version:

2020-05-01

Skapar eller uppdaterar hierarkiinställningarna som definierats på hanteringsgruppsnivå.

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/settings/default?api-version=2020-05-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
groupId	path	True	string	Hanteringsgrupps-ID.
api-version	query	True	string	Version av API:et som ska användas med klientbegäran. Den aktuella versionen är 2018-01-01-preview.

Begärandetext

Name	Typ	Description
properties.defaultManagementGroup	string	Inställningar som anger standardhanteringsgruppen under vilken nya prenumerationer läggs till i den här klientorganisationen. Till exempel /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Anger om RBAC-åtkomst krävs när gruppen skapas under rothanteringsgruppen. Om värdet är true kräver användaren åtgärden Microsoft.Management/managementGroups/write i rothanteringsgruppens omfång för att kunna skapa nya grupper direkt under roten. Detta hindrar nya användare från att skapa nya hanteringsgrupper, såvida de inte får åtkomst.

Svar

Name	Typ	Description
200 OK	HierarchySettings	OK
Other Status Codes	ErrorResponse	Fel

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

GetGroupSettings

Exempelbegäran

HTTP

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

{
  "properties": {
    "defaultManagementGroup": "/providers/Microsoft.Management/managementGroups/DefaultGroup",
    "requireAuthorizationForGroupCreation": true
  }
}

Exempelsvar

Statuskod:

200

{
  "id": "/providers/Microsoft.Management/managementGroups/root/settings/default",
  "type": "Microsoft.Management/managementGroups/settings",
  "name": "root",
  "properties": {
    "tenantId": "20000000-0000-0000-0000-000000000000",
    "defaultManagementGroup": "/providers/Microsoft.Management/managementGroups/DefaultGroup",
    "requireAuthorizationForGroupCreation": true
  }
}

Definitioner

Name	Description
CreateOrUpdateSettingsRequest	Parametrar för att skapa eller uppdatera inställningar för hanteringsgrupp
ErrorDetails	Information om felet.
ErrorResponse	Felobjektet.
HierarchySettings	Inställningar som definierats i hanteringsgruppens omfång.

CreateOrUpdateSettingsRequest

Objekt

Parametrar för att skapa eller uppdatera inställningar för hanteringsgrupp

Name	Typ	Description
properties.defaultManagementGroup	string	Inställningar som anger standardhanteringsgruppen under vilken nya prenumerationer läggs till i den här klientorganisationen. Till exempel /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Anger om RBAC-åtkomst krävs när gruppen skapas under rothanteringsgruppen. Om värdet är true kräver användaren åtgärden Microsoft.Management/managementGroups/write i rothanteringsgruppens omfång för att kunna skapa nya grupper direkt under roten. Detta hindrar nya användare från att skapa nya hanteringsgrupper, såvida de inte får åtkomst.

ErrorDetails

Objekt

Information om felet.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
details	string	En mänsklig läsbar representation av felets information.
message	string	En mänsklig läsbar representation av felet.

ErrorResponse

Objekt

Felobjektet.

Name	Typ	Description
error	ErrorDetails	Fel Information om felet.

HierarchySettings

Objekt

Inställningar som definierats i hanteringsgruppens omfång.

Name	Typ	Description
id	string	Det fullständigt kvalificerade ID:t för inställningsobjektet. Till exempel /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000000000000/settings/default.
name	string	Namnet på objektet. I det här fallet standard.
properties.defaultManagementGroup	string	Inställningar som anger standardhanteringsgruppen under vilken nya prenumerationer läggs till i den här klientorganisationen. Till exempel /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Anger om RBAC-åtkomst krävs när gruppen skapas under rothanteringsgruppen. Om värdet är true kräver användaren åtgärden Microsoft.Management/managementGroups/write i rothanteringsgruppens omfång för att kunna skapa nya grupper direkt under roten. Detta hindrar nya användare från att skapa nya hanteringsgrupper, såvida de inte får åtkomst.
properties.tenantId	string	Det AAD-klient-ID som är associerat med hierarkiinställningarna. Till exempel 000000000-0000-0000-0000-000000000000
type	string	Resurstypen. Till exempel Microsoft.Management/managementGroups/settings.