Delen via


Hierarchy Settings - List

Hiermee haalt u alle hiërarchie-instellingen op die zijn gedefinieerd op het niveau van de beheergroep. Instellingen kunnen alleen worden ingesteld voor de hoofdbeheergroep van de hiërarchie.

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/settings?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.

Antwoorden

Name Type Description
200 OK

HierarchySettingsList

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

ListGroupSettings

Voorbeeldaanvraag

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/root/settings?api-version=2020-05-01

Voorbeeldrespons

{
  "value": [
    {
      "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
      }
    }
  ],
  "@nextLink": null
}

Definities

Name Description
ErrorDetails

De details van de fout.

ErrorResponse

Het foutobject.

HierarchySettingsInfo

De resource voor hiërarchie-instellingen.

HierarchySettingsList

Lijsten alle hiërarchie-instellingen.

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.

HierarchySettingsInfo

De resource voor hiërarchie-instellingen.

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.

HierarchySettingsList

Lijsten alle hiërarchie-instellingen.

Name Type Description
@nextLink

string

De URL die moet worden gebruikt voor het ophalen van de volgende set resultaten.

value

HierarchySettingsInfo[]

De lijst met hiërarchie-instellingen.