Udostępnij za pośrednictwem


Hierarchy Settings - Create Or Update

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, które ustawiają 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 zakresie głównej grupy zarządzania w celu utworzenia nowych grup 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 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

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ź

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

HierarchySettings

Ustawienia zdefiniowane w zakresie grupy zarządzania.

CreateOrUpdateSettingsRequest

Parametry tworzenia lub aktualizowania ustawień grupy zarządzania

Nazwa Typ Opis
properties.defaultManagementGroup

string

Ustawienia, które ustawiają 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 zakresie głównej grupy zarządzania w celu utworzenia nowych grup bezpośrednio w katalogu głównym. Uniemożliwi to nowym użytkownikom tworzenie nowych grup zarządzania, chyba że otrzymają dostęp.

ErrorDetails

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

Obiekt error.

Nazwa Typ Opis
error

ErrorDetails

Błąd
Szczegóły błędu.

HierarchySettings

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/0000000-0000-0000-0000-000000000000/settings/default.

name

string

Nazwa obiektu. W tym przypadku wartość domyślna.

properties.defaultManagementGroup

string

Ustawienia, które ustawiają 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 zakresie głównej grupy zarządzania w celu utworzenia nowych grup 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-00000000000000000

type

string

Typ zasobu. Na przykład Microsoft.Management/managementGroups/settings.