Hierarchy Settings - Update

Riferimento

Servizio:: Management Groups

Versione API:: 2020-05-01

Aggiornamenti le impostazioni della gerarchia definite a livello di gruppo di gestione.

PATCH 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à l'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	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

GetGroupSettings

Esempio di richiesta

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

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

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à l'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

Dettagli dell'errore.

Nome	Tipo	Descrizione
code	string	Uno dei set definiti 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.

HierarchySettings

Impostazioni definite nell'ambito del gruppo di gestione.

Nome	Tipo	Descrizione
id	string	ID completo per l'oggetto impostazioni. 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à l'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, 000000000-0000-0000-0000-0000000000000
type	string	Tipo di risorsa. Ad esempio, Microsoft.Management/managementGroups/settings.

Condividi tramite