Hierarchy Settings - Create Or Update

Dienst:

Management Groups

API-Version:

2020-05-01

Erstellt oder aktualisiert die Hierarchieeinstellungen, die auf Verwaltungsgruppenebene definiert sind.

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 der RBAC-Zugriff bei der Gruppenerstellung unter der Stammverwaltungsgruppe erforderlich ist. Wenn dieser Wert auf "true" festgelegt ist, erfordert 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	OKAY
Other Status Codes	ErrorResponse	Fehler

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

GetGroupSettings

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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 der Verwaltungsgruppe definiert sind.

CreateOrUpdateSettingsRequest

Objekt

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 der RBAC-Zugriff bei der Gruppenerstellung unter der Stammverwaltungsgruppe erforderlich ist. Wenn dieser Wert auf "true" festgelegt ist, erfordert 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

Objekt

Die Details des Fehlers.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
details	string	Eine lesbare Darstellung der Fehlerdetails.
message	string	Eine lesbare Darstellung des Fehlers.

ErrorResponse

Objekt

Das Fehlerobjekt.

Name	Typ	Beschreibung
error	ErrorDetails	Fehler Die Details des Fehlers.

HierarchySettings

Objekt

Einstellungen, die im Bereich der Verwaltungsgruppe definiert sind.

Name	Typ	Beschreibung
id	string	Die vollqualifizierte ID für das Einstellungsobjekt. Beispiel: /providers/Microsoft.Management/managementGroups/000000-0000-0000-0000-00000-000000000/settings/default.
name	string	Der Name des Objekts. In diesem Fall ist der Standardwert.
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 der RBAC-Zugriff bei der Gruppenerstellung unter der Stammverwaltungsgruppe erforderlich ist. Wenn dieser Wert auf "true" festgelegt ist, erfordert 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 AAD-Mandanten-ID, die den Hierarchieeinstellungen zugeordnet ist. Beispiel: 00000000-0000-0000-0000-0000000000000000
type	string	Der Typ der Ressource. Beispiel: Microsoft.Management/managementGroups/settings.