Condividi tramite


Hierarchy Settings - List

Ottiene tutte le impostazioni della gerarchia definite a livello di gruppo di gestione. Le impostazioni possono essere impostate solo nel gruppo di gestione radice della gerarchia.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
groupId
path True

string

ID gruppo di gestione.

api-version
query True

string

Versione dell'API da usare con la richiesta client. La versione corrente è 2018-01-01-preview.

Risposte

Nome Tipo Descrizione
200 OK

HierarchySettingsList

OK

Other Status Codes

ErrorResponse

Errore

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

ListGroupSettings

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
ErrorDetails

Dettagli dell'errore.

ErrorResponse

Oggetto error.

HierarchySettingsInfo

Risorsa delle impostazioni della gerarchia.

HierarchySettingsList

Elenchi tutte le impostazioni della gerarchia.

ErrorDetails

Dettagli dell'errore.

Nome Tipo Descrizione
code

string

Uno di un set definito dal server di codici di errore.

details

string

Rappresentazione leggibile dei dettagli dell'errore.

message

string

Rappresentazione leggibile dell'errore.

ErrorResponse

Oggetto error.

Nome Tipo Descrizione
error

ErrorDetails

Errore
Dettagli dell'errore.

HierarchySettingsInfo

Risorsa delle impostazioni della gerarchia.

Nome Tipo Descrizione
id

string

ID completo per l'oggetto impostazioni. Ad esempio, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000000000000/settings/default.

name

string

Nome dell'oggetto. In questo caso, impostazione predefinita.

properties.defaultManagementGroup

string

Impostazioni che impostano il gruppo di gestione predefinito in cui vengono aggiunte nuove sottoscrizioni in questo tenant. Ad esempio, /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation

boolean

Indica se l'accesso in base al ruolo è necessario al momento della creazione del gruppo nel gruppo di gestione radice. Se impostato su true, l'utente richiederà un'azione Microsoft.Management/managementGroups/write nell'ambito del gruppo di gestione radice per creare nuovi gruppi direttamente nella radice. Ciò impedirà ai nuovi utenti di creare nuovi gruppi di gestione, a meno che non vengano assegnati l'accesso.

properties.tenantId

string

ID tenant AAD associato alle impostazioni della gerarchia. Ad esempio, 000000000-0000-0000-0000-0000000000000000

type

string

Tipo di risorsa. Ad esempio, Microsoft.Management/managementGroups/settings.

HierarchySettingsList

Elenchi tutte le impostazioni della gerarchia.

Nome Tipo Descrizione
@nextLink

string

URL da usare per ottenere il set successivo di risultati.

value

HierarchySettingsInfo[]

Elenco delle impostazioni della gerarchia.