Dela via


Hierarchy Settings - Update

Uppdateringar hierarkiinställningarna som definierats på hanteringsgruppsnivå.

PATCH 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 sant kräver användaren åtgärden Microsoft.Management/managementGroups/write i rothanteringsgruppens omfång för att skapa nya grupper direkt under roten. Detta förhindrar 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.

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

PATCH 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

{
  "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

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 sant kräver användaren åtgärden Microsoft.Management/managementGroups/write i rothanteringsgruppens omfång för att skapa nya grupper direkt under roten. Detta förhindrar 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 återgivning av felinformationen.

message

string

En läsbar återgivning av felet.

ErrorResponse

Felobjektet.

Name Typ Description
error

ErrorDetails

Fel
Information om felet.

HierarchySettings

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-0000000000000000/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 sant kräver användaren åtgärden Microsoft.Management/managementGroups/write i rothanteringsgruppens omfång för att skapa nya grupper direkt under roten. Detta förhindrar 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-0000000000000000

type

string

Resurstypen. Till exempel Microsoft.Management/managementGroups/settings.