Hierarchy Settings - Create Or Update

Service:

Management Groups

API Version:

2020-05-01

Erstellt oder aktualisiert die auf Verwaltungsgruppenebene definierten Hierarchieeinstellungen.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
groupId	path	True	string	Verwaltungsgruppen-ID.
api-version	query	True	string	Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2018-01-01-preview.

Anforderungstext

Name	Typ	Beschreibung
properties.defaultManagementGroup	string	Einstellungen, die die Standardverwaltungsgruppe festlegen, unter der neue Abonnements in diesem Mandanten hinzugefügt werden. Beispiel: /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Gibt an, ob bei der Gruppenerstellung unter der Stammverwaltungsgruppe RBAC-Zugriff erforderlich ist. Wenn dieser Wert auf true festgelegt ist, benötigt der Benutzer die Aktion Microsoft.Management/managementGroups/write im Bereich der Stammverwaltungsgruppe, um neue Gruppen direkt unter dem Stamm zu erstellen. Dadurch wird verhindert, dass neue Benutzer neue Verwaltungsgruppen erstellen, es sei denn, sie erhalten Zugriff.

Antworten

Name	Typ	Beschreibung
200 OK	HierarchySettings	OK
Other Status Codes	ErrorResponse	Fehler

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

GetGroupSettings

Sample Request

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

Sample Response

Status code:

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

Definitionen

Name	Beschreibung
CreateOrUpdateSettingsRequest	Parameter zum Erstellen oder Aktualisieren von Verwaltungsgruppeneinstellungen
ErrorDetails	Die Details des Fehlers.
ErrorResponse	Das Fehlerobjekt.
HierarchySettings	Einstellungen, die im Bereich "Verwaltungsgruppe" definiert sind.

CreateOrUpdateSettingsRequest

Parameter zum Erstellen oder Aktualisieren von Verwaltungsgruppeneinstellungen

Name	Typ	Beschreibung
properties.defaultManagementGroup	string	Einstellungen, die die Standardverwaltungsgruppe festlegen, unter der neue Abonnements in diesem Mandanten hinzugefügt werden. Beispiel: /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Gibt an, ob bei der Gruppenerstellung unter der Stammverwaltungsgruppe RBAC-Zugriff erforderlich ist. Wenn dieser Wert auf true festgelegt ist, benötigt der Benutzer die Aktion Microsoft.Management/managementGroups/write im Bereich der Stammverwaltungsgruppe, um neue Gruppen direkt unter dem Stamm zu erstellen. Dadurch wird verhindert, dass neue Benutzer neue Verwaltungsgruppen erstellen, es sei denn, sie erhalten Zugriff.

ErrorDetails

Die Details des Fehlers.

Name	Typ	Beschreibung
code	string	Einer von einem serverdefiniertem Satz von Fehlercodes.
details	string	Eine lesbare Darstellung der Fehlerdetails.
message	string	Eine lesbare Darstellung des Fehlers.

ErrorResponse

Das Fehlerobjekt.

Name	Typ	Beschreibung
error	ErrorDetails	Fehler Die Details des Fehlers.

HierarchySettings

Einstellungen, die im Bereich "Verwaltungsgruppe" definiert sind.

Name	Typ	Beschreibung
id	string	Die vollqualifizierte ID für das Einstellungsobjekt. Beispiel: /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000000000/settings/default.
name	string	Der Name des Objekts. In diesem Fall standard.
properties.defaultManagementGroup	string	Einstellungen, die die Standardverwaltungsgruppe festlegen, unter der neue Abonnements in diesem Mandanten hinzugefügt werden. Beispiel: /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Gibt an, ob bei der Gruppenerstellung unter der Stammverwaltungsgruppe RBAC-Zugriff erforderlich ist. Wenn dieser Wert auf true festgelegt ist, benötigt der Benutzer die Aktion Microsoft.Management/managementGroups/write im Bereich der Stammverwaltungsgruppe, um neue Gruppen direkt unter dem Stamm zu erstellen. Dadurch wird verhindert, dass neue Benutzer neue Verwaltungsgruppen erstellen, es sei denn, sie erhalten Zugriff.
properties.tenantId	string	Die den Hierarchieeinstellungen zugeordnete AAD-Mandanten-ID. Beispiel: 00000000-0000-0000-0000-0000000000000
type	string	Der Typ der Ressource. Beispiel: Microsoft.Management/managementGroups/settings.