Partager via


Hierarchy Settings - Create Or Update

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 a besoin de l’action Microsoft.Management/managementGroups/write sur l’étendue du groupe d’administration racine afin de créer des groupes directement sous la racine. Cela empêchera les nouveaux utilisateurs de créer des groupes d’administration, sauf s’ils bénéficient d’un accès.

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

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

{
  "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 de groupe d’administration

ErrorDetails

Détails de l’erreur.

ErrorResponse

Objet d’erreur.

HierarchySettings

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

CreateOrUpdateSettingsRequest

Paramètres de création ou de mise à jour des paramètres de 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 afin de créer des groupes directement sous la racine. Cela empêchera les nouveaux utilisateurs de créer des groupes d’administration, sauf s’ils bénéficient d’un accès.

ErrorDetails

Détails de l’erreur.

Nom Type Description
code

string

Un des 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

Objet d’erreur.

Nom Type Description
error

ErrorDetails

Erreur
Détails de l’erreur.

HierarchySettings

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

Nom Type Description
id

string

ID complet de l’objet settings. Par exemple, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000/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 afin de créer des groupes directement sous la racine. Cela empêchera les nouveaux utilisateurs de créer des groupes d’administration, sauf s’ils bénéficient d’un accès.

properties.tenantId

string

ID de locataire AAD associé aux paramètres de hiérarchie. Par exemple, 0000000-0000-0000-0000-0000000000000

type

string

Type de la ressource. Par exemple, Microsoft.Management/managementGroups/settings.