Hierarchy Settings - Update

Référence

Service:: Management Groups

Version d'API:: 2020-05-01

Mises à jour les paramètres de hiérarchie définis au niveau du groupe d’administration.

PATCH 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 du client. 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 a besoin de l’action Microsoft.Management/managementGroups/write sur l’étendue du groupe d’administration racine pour créer des groupes directement sous la racine. Cela empêchera les nouveaux utilisateurs de créer des groupes d’administration, sauf s’ils sont autorisés à y accéder.

Réponses

Nom	Type	Description
200 OK	HierarchySettings	Ok
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

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

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 pour la création ou la mise à jour des paramètres du groupe d’administration
ErrorDetails	Détails de l’erreur.
ErrorResponse	Objet error.
HierarchySettings	Paramètres définis dans l’étendue du groupe d’administration.

CreateOrUpdateSettingsRequest

Paramètres pour la création ou la 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 a besoin de l’action Microsoft.Management/managementGroups/write sur l’étendue du groupe d’administration racine pour créer des groupes directement sous la racine. Cela empêchera les nouveaux utilisateurs de créer des groupes d’administration, sauf s’ils sont autorisés à y accéder.

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.

HierarchySettings

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-0000000000000/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 a besoin de l’action Microsoft.Management/managementGroups/write sur l’étendue du groupe d’administration racine pour créer des groupes directement sous la racine. Cela empêchera les nouveaux utilisateurs de créer des groupes d’administration, sauf s’ils sont autorisés à y accéder.
properties.tenantId	string	ID de locataire AAD associé aux paramètres de hiérarchie. Par exemple, 00000000-0000-0000-0000-00000000000
type	string	Type de la ressource. Par exemple, Microsoft.Management/managementGroups/settings.

Partager via