Hierarchy Settings - Update

Referentie

Service:: Management Groups

API-versie:: 2020-05-01

Updates de hiërarchie-instellingen die zijn gedefinieerd op het niveau van de beheergroep.

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

URI-parameters

Name	In	Vereist	Type	Description
groupId	path	True	string	Beheergroep-id.
api-version	query	True	string	Versie van de API die moet worden gebruikt met de clientaanvraag. De huidige versie is 2018-01-01-preview.

Aanvraagbody

Name	Type	Description
properties.defaultManagementGroup	string	Instellingen waarmee de standaardbeheergroep wordt ingesteld waaronder nieuwe abonnementen worden toegevoegd in deze tenant. Bijvoorbeeld /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Geeft aan of RBAC-toegang is vereist bij het maken van de groep in de hoofdbeheergroep. Als deze optie is ingesteld op true, vereist de gebruiker de actie Microsoft.Management/managementGroups/write in het hoofdbereik van de beheergroep om nieuwe groepen rechtstreeks onder de hoofdmap te maken. Dit voorkomt dat nieuwe gebruikers nieuwe beheergroepen maken, tenzij ze toegang krijgen.

Antwoorden

Name	Type	Description
200 OK	HierarchySettings	OK
Other Status Codes	ErrorResponse	Fout

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

GetGroupSettings

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Definities

Name	Description
CreateOrUpdateSettingsRequest	Parameters voor het maken of bijwerken van instellingen voor beheergroepen
ErrorDetails	De details van de fout.
ErrorResponse	Het foutobject.
HierarchySettings	Instellingen die zijn gedefinieerd in het bereik van de beheergroep.

CreateOrUpdateSettingsRequest

Parameters voor het maken of bijwerken van instellingen voor beheergroepen

Name	Type	Description
properties.defaultManagementGroup	string	Instellingen waarmee de standaardbeheergroep wordt ingesteld waaronder nieuwe abonnementen worden toegevoegd in deze tenant. Bijvoorbeeld /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Geeft aan of RBAC-toegang is vereist bij het maken van de groep in de hoofdbeheergroep. Als deze optie is ingesteld op true, vereist de gebruiker de actie Microsoft.Management/managementGroups/write in het hoofdbereik van de beheergroep om nieuwe groepen rechtstreeks onder de hoofdmap te maken. Dit voorkomt dat nieuwe gebruikers nieuwe beheergroepen maken, tenzij ze toegang krijgen.

ErrorDetails

De details van de fout.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
details	string	Een door mensen leesbare weergave van de details van de fout.
message	string	Een door mensen leesbare weergave van de fout.

ErrorResponse

Het foutobject.

Name	Type	Description
error	ErrorDetails	Fout De details van de fout.

HierarchySettings

Instellingen die zijn gedefinieerd in het bereik van de beheergroep.

Name	Type	Description
id	string	De volledig gekwalificeerde id voor het instellingenobject. Bijvoorbeeld /providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-00000000000000/settings/default.
name	string	De naam van het object. In dit geval standaard.
properties.defaultManagementGroup	string	Instellingen waarmee de standaardbeheergroep wordt ingesteld waaronder nieuwe abonnementen worden toegevoegd in deze tenant. Bijvoorbeeld /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Geeft aan of RBAC-toegang is vereist bij het maken van de groep in de hoofdbeheergroep. Als deze optie is ingesteld op true, vereist de gebruiker de actie Microsoft.Management/managementGroups/write in het hoofdbereik van de beheergroep om nieuwe groepen rechtstreeks onder de hoofdmap te maken. Dit voorkomt dat nieuwe gebruikers nieuwe beheergroepen maken, tenzij ze toegang krijgen.
properties.tenantId	string	De AAD-tenant-id die is gekoppeld aan de hiërarchie-instellingen. Bijvoorbeeld 000000000-0000-0000-0000-000000000000000
type	string	Het type resource. Bijvoorbeeld Microsoft.Management/managementGroups/settings.

Delen via