Hierarchy Settings - Create Or Update

Služba:

Management Groups

Verze rozhraní API:

2020-05-01

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, pod kterou se do tohoto tenanta přidají nová předplatná. Například /providers/Microsoft.Management/managementGroups/defaultGroups
properties.requireAuthorizationForGroupCreation	boolean	Určuje, jestli se při vytváření skupiny v kořenové skupině vyžaduje přístup RBAC. Pokud je nastavená hodnota true, bude uživatel vyžadovat akci Microsoft.Management/managementGroups/write v oboru kořenové skupiny pro správu, aby mohl vytvářet nové skupiny přímo v kořenovém adresáři. Tím zabráníte novým uživatelům vytvářet nové skupiny pro správu, pokud jim není udělen přístup.

Odpovědi

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

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

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

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

Ukázková odpověď

Stavový kód:

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

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

Objekt

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, pod kterou se do tohoto tenanta přidají nová předplatná. Například /providers/Microsoft.Management/managementGroups/defaultGroups
properties.requireAuthorizationForGroupCreation	boolean	Určuje, jestli se při vytváření skupiny v kořenové skupině vyžaduje přístup RBAC. Pokud je nastavená hodnota true, bude uživatel vyžadovat akci Microsoft.Management/managementGroups/write v oboru kořenové skupiny pro správu, aby mohl vytvářet nové skupiny přímo v kořenovém adresáři. Tím zabráníte novým uživatelům vytvářet nové skupiny pro správu, pokud jim není udělen přístup.

ErrorDetails

Objekt

Podrobnosti o chybě.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
details	string	Čitelné znázornění podrobností chyby člověkem
message	string	Čitelné znázornění chyby člověkem.

ErrorResponse

Objekt

Objekt chyby.

Name	Typ	Description
error	ErrorDetails	Chyba Podrobnosti o chybě.

HierarchySettings

Objekt

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-00000000000/settings/default.
name	string	Název objektu. V tomto případě je výchozí.
properties.defaultManagementGroup	string	Nastavení, která nastaví výchozí skupinu pro správu, pod kterou se do tohoto tenanta přidají nová předplatná. Například /providers/Microsoft.Management/managementGroups/defaultGroups
properties.requireAuthorizationForGroupCreation	boolean	Určuje, jestli se při vytváření skupiny v kořenové skupině vyžaduje přístup RBAC. Pokud je nastavená hodnota true, bude uživatel vyžadovat akci Microsoft.Management/managementGroups/write v oboru kořenové skupiny pro správu, aby mohl vytvářet nové skupiny přímo v kořenovém adresáři. Tím zabráníte novým uživatelům vytvářet nové skupiny pro správu, pokud jim není udělen přístup.
properties.tenantId	string	ID tenanta AAD přidružené k nastavení hierarchie. Například 00000000-0000-0000-0000-0000000000000
type	string	Typ prostředku. Například Microsoft.Management/managementGroups/settings.