Management Groups - Create Or Update

Référence

Service:: Management Groups

API Version:: 2020-05-01

Crée ou met à jour un groupe d’administration. Si un groupe d’administration est déjà créé et qu’une demande de création ultérieure est émise avec des propriétés différentes, les propriétés du groupe d’administration sont mises à jour.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
groupId	path	True	string	ID du groupe d’administration.
api-version	query	True	string	Version de l’API à utiliser avec la demande du client. La version actuelle est 2018-01-01-preview.

En-tête de la demande

Nom	Obligatoire	Type	Description
Cache-Control		string	Indique que la requête ne doit pas utiliser de caches.

Corps de la demande

Nom	Type	Description
name	string	Nom du groupe d’administration. Par exemple, 00000000-0000-0000-0000-00000000000
properties.details	CreateManagementGroupDetails	Détails Détails d’un groupe d’administration utilisé lors de la création.
properties.displayName	string	Nom convivial du groupe d’administration. Si aucune valeur n’est passée, ce champ est défini sur groupId.

Réponses

Nom	Type	Description
200 OK	ManagementGroup	Ok
202 Accepted	AzureAsyncOperationResults	Accepté Headers Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Erreur

Nom

Type

Description

200 OK

ManagementGroup

202 Accepted

AzureAsyncOperationResults

Accepté

Headers

Location: string
Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Erreur

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

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

Scopes

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

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

Définitions

Nom	Description
AzureAsyncOperationResults	Résultats d’Azure-AsyncOperation.
CreateManagementGroupChildInfo	Informations enfants d’un groupe d’administration utilisé lors de la création.
CreateManagementGroupDetails	Détails d’un groupe d’administration utilisé lors de la création.
CreateManagementGroupRequest	Paramètres de création de groupe d’administration.
CreateParentGroupInfo	(Facultatif) ID du groupe d’administration parent utilisé lors de la création.
ErrorDetails	Détails de l’erreur.
ErrorResponse	Objet error.
ManagementGroup	Détails du groupe d’administration.
ManagementGroupChildInfo	Informations enfants d’un groupe d’administration.
ManagementGroupChildType	Type de ressource enfant.
ManagementGroupDetails	Détails d’un groupe d’administration.
ManagementGroupPathElement	Élément path d’un groupe d’administration ancêtres.
ParentGroupInfo	(Facultatif) ID du groupe d’administration parent.

AzureAsyncOperationResults

Résultats d’Azure-AsyncOperation.

Nom	Type	Description
id	string	ID complet du groupe d’administration. Par exemple, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000
name	string	Nom du groupe d’administration. Par exemple, 00000000-0000-0000-0000-00000000000
properties.displayName	string	Nom convivial du groupe d’administration.
properties.tenantId	string	ID de locataire AAD associé au groupe d’administration. Par exemple, 00000000-0000-0000-0000-00000000000
status	string	La status actuelle de l’opération asynchrone effectuée. Par exemple, En cours d’exécution, Réussi, Échec
type	string	Type de la ressource. Par exemple, Microsoft.Management/managementGroups

CreateManagementGroupChildInfo

Informations enfants d’un groupe d’administration utilisé lors de la création.

Nom	Type	Description
children	CreateManagementGroupChildInfo[]	Liste des enfants.
displayName	string	Nom convivial de la ressource enfant.
id	string	ID complet de la ressource enfant (groupe d’administration ou abonnement). Par exemple, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000
name	string	Nom de l’entité enfant.
type	ManagementGroupChildType	Type de ressource enfant. Type de ressource complet qui inclut l’espace de noms du fournisseur (par exemple, Microsoft.Management/managementGroups)

CreateManagementGroupDetails

Détails d’un groupe d’administration utilisé lors de la création.

Nom	Type	Description
parent	CreateParentGroupInfo	Parent (Facultatif) ID du groupe d’administration parent utilisé lors de la création.
updatedBy	string	Identité du principal ou du processus qui a mis à jour l’objet.
updatedTime	string	Date et heure de la dernière mise à jour de cet objet.
version	number	Numéro de version de l’objet.

CreateManagementGroupRequest

Paramètres de création de groupe d’administration.

Nom	Type	Description
id	string	ID complet du groupe d’administration. Par exemple, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000
name	string	Nom du groupe d’administration. Par exemple, 00000000-0000-0000-0000-00000000000
properties.children	CreateManagementGroupChildInfo[]	Liste des enfants.
properties.details	CreateManagementGroupDetails	Détails Détails d’un groupe d’administration utilisé lors de la création.
properties.displayName	string	Nom convivial du groupe d’administration. Si aucune valeur n’est passée, ce champ est défini sur groupId.
properties.tenantId	string	ID de locataire AAD associé au groupe d’administration. Par exemple, 00000000-0000-0000-0000-00000000000
type	string	Type de la ressource. Par exemple, Microsoft.Management/managementGroups

CreateParentGroupInfo

(Facultatif) ID du groupe d’administration parent utilisé lors de la création.

Nom	Type	Description
displayName	string	Nom convivial du groupe d’administration parent.
id	string	ID complet du groupe d’administration parent. Par exemple, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000
name	string	Nom du groupe d’administration parent

ErrorDetails

Détails de l’erreur.

Nom	Type	Description
code	string	Un des ensembles de codes d’erreur définis par le serveur.
details	string	Représentation lisible des détails de l’erreur.
message	string	Représentation lisible de l’erreur.

ErrorResponse

Objet error.

Nom	Type	Description
error	ErrorDetails	Erreur Détails de l’erreur.