Sdílet prostřednictvím


Hierarchy Settings - Create Or Update

Vytvoří nebo aktualizuje nastavení hierarchie definované na úrovni skupiny pro správu.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
groupId
path True

string

ID skupiny pro správu.

api-version
query True

string

Verze rozhraní API, která se má použít s požadavkem klienta. Aktuální verze je 2018-01-01-preview.

Text požadavku

Name Typ Description
properties.defaultManagementGroup

string

Nastavení, která nastaví výchozí skupinu pro správu, ve které se do tohoto tenanta přidávají nová předplatná. Například /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation

boolean

Určuje, jestli se při vytváření skupiny v kořenové skupině pro správu vyžaduje přístup RBAC. Pokud je nastavená hodnota true, uživatel bude vyžadovat akci Microsoft.Management/managementGroups/write v oboru kořenové skupiny pro správu, aby mohl vytvořit nové skupiny přímo v kořenovém adresáři. To zabrání novým uživatelům ve vytváření nových skupin pro správu, pokud jim nebude udělen přístup.

Odpovědi

Name Typ Description
200 OK

HierarchySettings

OK

Other Status Codes

ErrorResponse

Chyba

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

GetGroupSettings

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
CreateOrUpdateSettingsRequest

Parametry pro vytváření nebo aktualizaci nastavení skupiny pro správu

ErrorDetails

Podrobnosti o chybě.

ErrorResponse

Objekt chyby.

HierarchySettings

Nastavení definovaná v oboru skupiny pro správu.

CreateOrUpdateSettingsRequest

Parametry pro vytváření nebo aktualizaci nastavení skupiny pro správu

Name Typ Description
properties.defaultManagementGroup

string

Nastavení, která nastaví výchozí skupinu pro správu, ve které se do tohoto tenanta přidávají nová předplatná. Například /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation

boolean

Určuje, jestli se při vytváření skupiny v kořenové skupině pro správu vyžaduje přístup RBAC. Pokud je nastavená hodnota true, uživatel bude vyžadovat akci Microsoft.Management/managementGroups/write v oboru kořenové skupiny pro správu, aby mohl vytvořit nové skupiny přímo v kořenovém adresáři. To zabrání novým uživatelům ve vytváření nových skupin pro správu, pokud jim nebude udělen přístup.

ErrorDetails

Podrobnosti o chybě.

Name Typ Description
code

string

Jeden ze serverem definované sady kódů chyb.

details

string

Lidsky čitelná reprezentace podrobností o chybě.

message

string

Lidsky čitelná reprezentace chyby.

ErrorResponse

Objekt chyby.

Name Typ Description
error

ErrorDetails

Chyba
Podrobnosti o chybě.

HierarchySettings

Nastavení definovaná v oboru skupiny pro správu.

Name Typ Description
id

string

Plně kvalifikované ID objektu nastavení. Například /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000/settings/default.

name

string

Název objektu. V tomto případě výchozí.

properties.defaultManagementGroup

string

Nastavení, která nastaví výchozí skupinu pro správu, ve které se do tohoto tenanta přidávají nová předplatná. Například /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation

boolean

Určuje, jestli se při vytváření skupiny v kořenové skupině pro správu vyžaduje přístup RBAC. Pokud je nastavená hodnota true, uživatel bude vyžadovat akci Microsoft.Management/managementGroups/write v oboru kořenové skupiny pro správu, aby mohl vytvořit nové skupiny přímo v kořenovém adresáři. To zabrání novým uživatelům ve vytváření nových skupin pro správu, pokud jim nebude udělen přístup.

properties.tenantId

string

ID tenanta AAD přidružené k nastavení hierarchie. Například 00000000-0000-0000-0000-000000000000000000

type

string

Typ prostředku. Například Microsoft.Management/managementGroups/settings.