Hierarchy Settings - Create Or Update

Servizio:

Management Groups

Versione API:

2020-05-01

Crea o aggiorna le impostazioni della gerarchia definite a livello di gruppo di gestione.

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

Corpo della richiesta

Nome	Tipo	Descrizione
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 controllo degli accessi 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 abbiano accesso.

Risposte

Nome	Tipo	Descrizione
200 OK	HierarchySettings	Va bene
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

GetGroupSettings

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
CreateOrUpdateSettingsRequest	Parametri per la creazione o l'aggiornamento delle impostazioni del gruppo di gestione
ErrorDetails	Dettagli dell'errore.
ErrorResponse	Oggetto error.
HierarchySettings	Impostazioni definite nell'ambito del gruppo di gestione.

CreateOrUpdateSettingsRequest

Object

Parametri per la creazione o l'aggiornamento delle impostazioni del gruppo di gestione

Nome	Tipo	Descrizione
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 controllo degli accessi 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 abbiano accesso.

ErrorDetails

Object

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

Object

Oggetto error.

Nome	Tipo	Descrizione
error	ErrorDetails	Errore Dettagli dell'errore.

HierarchySettings

Object

Impostazioni definite nell'ambito del gruppo di gestione.

Nome	Tipo	Descrizione
id	string	ID completo per l'oggetto settings. Ad esempio, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000/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 controllo degli accessi 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 abbiano accesso.
properties.tenantId	string	ID tenant di AAD associato alle impostazioni della gerarchia. Ad esempio, 00000000-0000-0000-0000-000000000000
type	string	Tipo della risorsa. Ad esempio, Microsoft.Management/managementGroups/settings.