Hierarchy Settings - Create Or Update

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 In Required Type 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 Type 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 Type Description
200 OK

OK

Other Status Codes

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

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

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

CreateOrUpdateSettingsRequest

Parametrar för att skapa eller uppdatera hanteringsgruppsinställningar

ErrorDetails

Information om felet.

ErrorResponse

Felobjektet.

HierarchySettings

Inställningar definieras i omfånget hanteringsgrupp.

CreateOrUpdateSettingsRequest

Parametrar för att skapa eller uppdatera hanteringsgruppsinställningar

Name Type 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 Type 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 Type Description
error

Fel
Information om felet.

HierarchySettings

Inställningar definieras i omfånget hanteringsgrupp.

Name Type 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.