Hierarchy Settings - Create Or Update

Referens

Service:: Management Groups

API Version:: 2020-05-01

Skapar eller uppdaterar de hierarkiinställningar 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	Grupp-ID för hantering.
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 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

GetGroupSettings

Sample Request

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

Sample Response

Status code:: 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 hanteringsgruppsinställningar
ErrorDetails	Information om felet.
ErrorResponse	Felobjektet.
HierarchySettings	Inställningar som definierats i omfånget Hanteringsgrupp.

CreateOrUpdateSettingsRequest

Parametrar för att skapa eller uppdatera hanteringsgruppsinställningar

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

Information om felet.

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

ErrorResponse

Felobjektet.

Name	Typ	Description
error	ErrorDetails	Fel Information om felet.

HierarchySettings

Inställningar som definierats i omfånget Hanteringsgrupp.

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-0000-00000000000/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-klientorganisations-ID som är associerat med hierarkiinställningarna. Till exempel 00000000-0000-0000-0000-0000000000000
type	string	Resurstypen. Till exempel Microsoft.Management/managementGroups/settings.

Share via