Hierarchy Settings - Create Or Update

Usługa:

Management Groups

Wersja interfejsu API:

2020-05-01

Tworzy lub aktualizuje ustawienia hierarchii zdefiniowane na poziomie grupy zarządzania.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
groupId	path	True	string	Identyfikator grupy zarządzania.
api-version	query	True	string	Wersja interfejsu API do użycia z żądaniem klienta. Bieżąca wersja to 2018-01-01-preview.

Treść żądania

Nazwa	Typ	Opis
properties.defaultManagementGroup	string	Ustawienia ustawiające domyślną grupę zarządzania, w ramach której nowe subskrypcje są dodawane w tej dzierżawie. Na przykład /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Wskazuje, czy dostęp RBAC jest wymagany podczas tworzenia grupy w głównej grupie zarządzania. W przypadku ustawienia wartości true użytkownik będzie wymagać akcji Microsoft.Management/managementGroups/write w głównym zakresie grupy zarządzania, aby utworzyć nowe grupy bezpośrednio w katalogu głównym. Uniemożliwi to nowym użytkownikom tworzenie nowych grup zarządzania, chyba że otrzymają dostęp.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	HierarchySettings	OK
Other Status Codes	ErrorResponse	Błąd

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

GetGroupSettings

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
CreateOrUpdateSettingsRequest	Parametry tworzenia lub aktualizowania ustawień grupy zarządzania
ErrorDetails	Szczegóły błędu.
ErrorResponse	Obiekt błędu.
HierarchySettings	Ustawienia zdefiniowane w zakresie grupy zarządzania.

CreateOrUpdateSettingsRequest

Objekt

Parametry tworzenia lub aktualizowania ustawień grupy zarządzania

Nazwa	Typ	Opis
properties.defaultManagementGroup	string	Ustawienia ustawiające domyślną grupę zarządzania, w ramach której nowe subskrypcje są dodawane w tej dzierżawie. Na przykład /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Wskazuje, czy dostęp RBAC jest wymagany podczas tworzenia grupy w głównej grupie zarządzania. W przypadku ustawienia wartości true użytkownik będzie wymagać akcji Microsoft.Management/managementGroups/write w głównym zakresie grupy zarządzania, aby utworzyć nowe grupy bezpośrednio w katalogu głównym. Uniemożliwi to nowym użytkownikom tworzenie nowych grup zarządzania, chyba że otrzymają dostęp.

ErrorDetails

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
details	string	Czytelna dla człowieka reprezentacja szczegółów błędu.
message	string	Czytelna dla człowieka reprezentacja błędu.

ErrorResponse

Objekt

Obiekt błędu.

Nazwa	Typ	Opis
error	ErrorDetails	Błąd Szczegóły błędu.

HierarchySettings

Objekt

Ustawienia zdefiniowane w zakresie grupy zarządzania.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator obiektu ustawień. Na przykład /providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-000000000000/settings/default.
name	string	Nazwa obiektu. W tym przypadku wartość domyślna.
properties.defaultManagementGroup	string	Ustawienia ustawiające domyślną grupę zarządzania, w ramach której nowe subskrypcje są dodawane w tej dzierżawie. Na przykład /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Wskazuje, czy dostęp RBAC jest wymagany podczas tworzenia grupy w głównej grupie zarządzania. W przypadku ustawienia wartości true użytkownik będzie wymagać akcji Microsoft.Management/managementGroups/write w głównym zakresie grupy zarządzania, aby utworzyć nowe grupy bezpośrednio w katalogu głównym. Uniemożliwi to nowym użytkownikom tworzenie nowych grup zarządzania, chyba że otrzymają dostęp.
properties.tenantId	string	Identyfikator dzierżawy usługi AAD skojarzony z ustawieniami hierarchii. Na przykład 000000000-0000-0000-0000-00000000000000000000
type	string	Typ zasobu. Na przykład Microsoft.Management/managementGroups/settings.