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

Name In Required 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

Name Type Description
properties.defaultManagementGroup
  • string

Paramètres définissant 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 d’un groupe dans le groupe d’administration racine. Si la valeur est true, l’utilisateur requiert l’action Microsoft. Management/managementGroups/Write dans 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 de nouveaux Groupes d’administration, à moins qu’ils n’y aient accès.

Réponses

Name Type Description
200 OK

Ok

Other Status Codes

Error

Sécurité

azure_auth

Azure Active Directory le Flow OAuth2.

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

Scopes

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

Exemples

GetGroupSettings

Sample Request

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

Sample Response

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

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 d’erreur.

HierarchySettings

Paramètres définis au niveau de l’étendue du groupe d’administration.

CreateOrUpdateSettingsRequest

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

Name Type Description
properties.defaultManagementGroup
  • string

Paramètres définissant 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 d’un groupe dans le groupe d’administration racine. Si la valeur est true, l’utilisateur requiert l’action Microsoft. Management/managementGroups/Write dans 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 de nouveaux Groupes d’administration, à moins qu’ils n’y aient accès.

ErrorDetails

Détails de l’erreur.

Name Type Description
code
  • string

Un des ensembles de codes d’erreur définis par le serveur.

details
  • string

Représentation explicite des détails de l’erreur.

message
  • string

Représentation explicite de l’erreur.

ErrorResponse

Objet d’erreur.

Name Type Description
error

Error
Détails de l’erreur.

HierarchySettings

Paramètres définis au niveau de l’étendue du groupe d’administration.

Name Type Description
id
  • string

ID qualifié complet de l’objet de paramètres. 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 définissant 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 d’un groupe dans le groupe d’administration racine. Si la valeur est true, l’utilisateur requiert l’action Microsoft. Management/managementGroups/Write dans 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 de nouveaux Groupes d’administration, à moins qu’ils n’y aient accès.

properties.tenantId
  • string

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

type
  • string

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