Hierarchy Settings - Update

Reference

Služba:: Management Groups

Verze rozhraní API:: 2020-05-01

Aktualizace nastavení hierarchie definované na úrovni skupiny pro správu.

PATCH 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 v tomto tenantovi 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 rámci kořenové skupiny 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 vytvářet 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 nebudou mít 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

HTTP

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

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 vytvoř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 vytvoř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 v tomto tenantovi 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 rámci kořenové skupiny 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 vytvářet 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 nebudou mít přístup.

ErrorDetails

Podrobnosti o chybě.

Name	Typ	Description
code	string	Jeden ze serverem definovaných chybových kódů.
details	string	Pro člověka čitelná reprezentace podrobností chyby.
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-00000000000/settings/default.
name	string	Název objektu. V tomto případě je to výchozí.
properties.defaultManagementGroup	string	Nastavení, které nastaví výchozí skupinu pro správu, pod kterou se v tomto tenantovi 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 rámci kořenové skupiny 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 vytvářet 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 nebudou mít přístup.
properties.tenantId	string	ID tenanta AAD přidružené k nastavení hierarchie. Například 000000000-0000-0000-0000-0000000000000
type	string	Typ prostředku. Například Microsoft.Management/managementGroups/settings.

Sdílet prostřednictvím