Hierarchy Settings - Create Or Update

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 Required Type Description
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 Type Description
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 diese Einstellung 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, ihnen wird Zugriff gewährt.

Antworten

Name Type Description
200 OK

OK

Other Status Codes

Fehler

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

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

Scopes

Name Description
user_impersonation Identität Ihres Benutzerkontos annehmen

Beispiele

GetGroupSettings

Sample Request

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

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

CreateOrUpdateSettingsRequest

Parameter zum Erstellen oder Aktualisieren von Verwaltungsgruppeneinstellungen

ErrorDetails

Die Details des Fehlers.

ErrorResponse

Das Fehlerobjekt.

HierarchySettings

Einstellungen, die im Verwaltungsgruppenbereich definiert sind.

CreateOrUpdateSettingsRequest

Parameter zum Erstellen oder Aktualisieren von Verwaltungsgruppeneinstellungen

Name Type Description
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 diese Einstellung 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, ihnen wird Zugriff gewährt.

ErrorDetails

Die Details des Fehlers.

Name Type Description
code
  • string

Einer einer vom Server definierten Gruppe von Fehlercodes.

details
  • string

Eine lesbare Darstellung der Fehlerdetails.

message
  • string

Eine lesbare Darstellung des Fehlers.

ErrorResponse

Das Fehlerobjekt.

Name Type Description
error

Fehler
Die Details des Fehlers.

HierarchySettings

Einstellungen, die im Verwaltungsgruppenbereich definiert sind.

Name Type Description
id
  • string

Die vollqualifizierte ID für das Einstellungsobjekt. Beispiel: /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000/settings/default.

name
  • string

Der Name des Objekts. In diesem Fall ist dies 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 bei der Gruppenerstellung unter der Stammverwaltungsgruppe RBAC-Zugriff erforderlich ist. Wenn diese Einstellung 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, ihnen wird Zugriff gewährt.

properties.tenantId
  • string

Die AAD-Mandanten-ID, die den Hierarchieeinstellungen zugeordnet ist. Beispiel: 00000000-0000-0000-0000-000000000000

type
  • string

Der Typ der Ressource. Beispiel: Microsoft.Management/managementGroups/settings.