Management Groups - Create Or Update

Riferimento

Service:: Management Groups

API Version:: 2020-05-01

Crea o aggiorna un gruppo di gestione. Se viene già creato un gruppo di gestione e viene rilasciata una richiesta di creazione successiva con proprietà diverse, verranno aggiornate le proprietà del gruppo di gestione.

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

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Cache-Control		string	Indica che la richiesta non deve utilizzare cache.

Corpo della richiesta

Nome	Tipo	Descrizione
name	string	Nome del gruppo di gestione. Ad esempio, 000000000-0000-0000-0000-0000000000000
properties.details	CreateManagementGroupDetails	Dettagli Dettagli di un gruppo di gestione utilizzato durante la creazione.
properties.displayName	string	Nome descrittivo del gruppo di gestione. Se non viene passato alcun valore, questo campo verrà impostato sul groupId.

Risposte

Nome	Tipo	Descrizione
200 OK	ManagementGroup	OK
202 Accepted	AzureAsyncOperationResults	Accettato Headers Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Errore

Nome

Tipo

Descrizione

200 OK

ManagementGroup

202 Accepted

AzureAsyncOperationResults

Accettato

Headers

Location: string
Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Errore

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

PutManagementGroup

Sample Request

HTTP

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/ChildGroup?api-version=2020-05-01


{
  "properties": {
    "displayName": "ChildGroup",
    "details": {
      "parent": {
        "id": "/providers/Microsoft.Management/managementGroups/RootGroup"
      }
    }
  }
}

Sample Response

Status code:: 200

{
  "id": "/providers/Microsoft.Management/managementGroups/ChildGroup",
  "type": "Microsoft.Management/managementGroups",
  "name": "ChildGroup",
  "properties": {
    "tenantId": "20000000-0000-0000-0000-000000000000",
    "displayName": "ChildGroup",
    "details": {
      "version": 1,
      "updatedTime": "2018-01-01T00:00:00.00Z",
      "updatedBy": "16b8ef21-5c9f-420c-bcc9-e4f8c9f30b4b",
      "parent": {
        "id": "/providers/Microsoft.Management/managementGroups/RootGroup",
        "name": "RootGroup",
        "displayName": "RootGroup"
      }
    }
  }
}

Status code:: 202

{
  "id": "/providers/Microsoft.Management/managementGroups/ChildGroup",
  "type": "Microsoft.Management/managementGroups",
  "name": "ChildGroup",
  "status": "NotStarted"
}

Definizioni

Nome	Descrizione
AzureAsyncOperationResults	Risultati di Azure-AsyncOperation.
CreateManagementGroupChildInfo	Informazioni figlio di un gruppo di gestione utilizzato durante la creazione.
CreateManagementGroupDetails	Dettagli di un gruppo di gestione utilizzato durante la creazione.
CreateManagementGroupRequest	Parametri di creazione del gruppo di gestione.
CreateParentGroupInfo	(Facoltativo) ID del gruppo di gestione padre utilizzato durante la creazione.
ErrorDetails	Dettagli dell'errore.
ErrorResponse	Oggetto error.
ManagementGroup	Dettagli del gruppo di gestione.
ManagementGroupChildInfo	Informazioni figlio di un gruppo di gestione.
ManagementGroupChildType	Tipo di risorsa figlio.
ManagementGroupDetails	Dettagli di un gruppo di gestione.
ManagementGroupPathElement	Elemento path di un gruppo di gestione predecessori.
ParentGroupInfo	(Facoltativo) ID del gruppo di gestione padre.

AzureAsyncOperationResults

Risultati di Azure-AsyncOperation.

Nome	Tipo	Descrizione
id	string	ID completo per il gruppo di gestione. Ad esempio, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Nome del gruppo di gestione. Ad esempio, 000000000-0000-0000-0000-0000000000000
properties.displayName	string	Nome descrittivo del gruppo di gestione.
properties.tenantId	string	ID tenant di AAD associato al gruppo di gestione. Ad esempio, 000000000-0000-0000-0000-0000000000000
status	string	Stato corrente dell'operazione asincrona eseguita. Ad esempio, Running, Succeeded, Failed
type	string	Tipo di risorsa. Ad esempio, Microsoft.Management/managementGroups

CreateManagementGroupChildInfo

Informazioni figlio di un gruppo di gestione utilizzato durante la creazione.

Nome	Tipo	Descrizione
children	CreateManagementGroupChildInfo[]	Elenco di elementi figlio.
displayName	string	Nome descrittivo della risorsa figlio.
id	string	ID completo per la risorsa figlio (gruppo di gestione o sottoscrizione). Ad esempio, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Nome dell'entità figlio.
type	ManagementGroupChildType	Tipo di risorsa figlio. Tipo di risorsa completo che include lo spazio dei nomi del provider (ad esempio Microsoft.Management/managementGroups)

CreateManagementGroupDetails

Dettagli di un gruppo di gestione utilizzato durante la creazione.

Nome	Tipo	Descrizione
parent	CreateParentGroupInfo	Parent (Facoltativo) ID del gruppo di gestione padre utilizzato durante la creazione.
updatedBy	string	Identità dell'entità o del processo che ha aggiornato l'oggetto.
updatedTime	string	Data e ora dell'ultimo aggiornamento dell'oggetto.
version	number	Numero di versione dell'oggetto.

CreateManagementGroupRequest

Parametri di creazione del gruppo di gestione.

Nome	Tipo	Descrizione
id	string	ID completo per il gruppo di gestione. Ad esempio, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Nome del gruppo di gestione. Ad esempio, 000000000-0000-0000-0000-0000000000000
properties.children	CreateManagementGroupChildInfo[]	Elenco di elementi figlio.
properties.details	CreateManagementGroupDetails	Dettagli Dettagli di un gruppo di gestione utilizzato durante la creazione.
properties.displayName	string	Nome descrittivo del gruppo di gestione. Se non viene passato alcun valore, questo campo verrà impostato sul groupId.
properties.tenantId	string	ID tenant di AAD associato al gruppo di gestione. Ad esempio, 000000000-0000-0000-0000-0000000000000
type	string	Tipo di risorsa. Ad esempio, Microsoft.Management/managementGroups

CreateParentGroupInfo

(Facoltativo) ID del gruppo di gestione padre utilizzato durante la creazione.

Nome	Tipo	Descrizione
displayName	string	Nome descrittivo del gruppo di gestione padre.
id	string	ID completo per il gruppo di gestione padre. Ad esempio, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Nome del gruppo di gestione padre

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.