Hierarchy Settings - Create Or Update

Service:

Management Groups

Version d'API:

2020-05-01

Crée ou met à jour les paramètres de hiérarchie définis au niveau du groupe d’administration.

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/settings/default?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 cliente. La version actuelle est 2018-01-01-preview.

Corps de la demande

Nom	Type	Description
properties.defaultManagementGroup	string	Paramètres qui définissent le groupe d’administration par défaut sous lequel les nouveaux abonnements sont ajoutés dans ce locataire. Par exemple, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Indique si l’accès RBAC est requis lors de la création du groupe sous le groupe d’administration racine. Si la valeur est true, l’utilisateur nécessite l’action Microsoft.Management/managementGroups/write dans l’étendue du groupe d’administration racine afin de créer de nouveaux groupes directement sous la racine. Cela empêchera les nouveaux utilisateurs de créer de nouveaux groupes d’administration, sauf s’ils reçoivent un accès.

Réponses

Nom	Type	Description
200 OK	HierarchySettings	D’ACCORD
Other Status Codes	ErrorResponse	Erreur

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

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

Exemples

GetGroupSettings

Exemple de requête

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

Exemple de réponse

Code d’état:

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

Définitions

Nom	Description
CreateOrUpdateSettingsRequest	Paramètres de création ou de mise à jour des paramètres du groupe d’administration
ErrorDetails	Détails de l’erreur.
ErrorResponse	Objet d’erreur.
HierarchySettings	Paramètres définis dans l’étendue du groupe d’administration.

CreateOrUpdateSettingsRequest

Object

Paramètres de création ou de mise à jour des paramètres du groupe d’administration

Nom	Type	Description
properties.defaultManagementGroup	string	Paramètres qui définissent le groupe d’administration par défaut sous lequel les nouveaux abonnements sont ajoutés dans ce locataire. Par exemple, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Indique si l’accès RBAC est requis lors de la création du groupe sous le groupe d’administration racine. Si la valeur est true, l’utilisateur nécessite l’action Microsoft.Management/managementGroups/write dans l’étendue du groupe d’administration racine afin de créer de nouveaux groupes directement sous la racine. Cela empêchera les nouveaux utilisateurs de créer de nouveaux groupes d’administration, sauf s’ils reçoivent un accès.

ErrorDetails

Object

Détails de l’erreur.

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

ErrorResponse

Object

Objet d’erreur.

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

HierarchySettings

Object

Paramètres définis dans l’étendue du groupe d’administration.

Nom	Type	Description
id	string	ID complet de l’objet settings. Par exemple, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000-000000000/settings/default.
name	string	Nom de l’objet. Dans ce cas, valeur par défaut.
properties.defaultManagementGroup	string	Paramètres qui définissent le groupe d’administration par défaut sous lequel les nouveaux abonnements sont ajoutés dans ce locataire. Par exemple, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Indique si l’accès RBAC est requis lors de la création du groupe sous le groupe d’administration racine. Si la valeur est true, l’utilisateur nécessite l’action Microsoft.Management/managementGroups/write dans l’étendue du groupe d’administration racine afin de créer de nouveaux groupes directement sous la racine. Cela empêchera les nouveaux utilisateurs de créer de nouveaux groupes d’administration, sauf s’ils reçoivent un accès.
properties.tenantId	string	ID de locataire AAD associé aux paramètres de hiérarchie. Par exemple, 00000000-0000-0000-0000-000000000000000
type	string	Type de la ressource. Par exemple, Microsoft.Management/managementGroups/settings.