Partager via


Hierarchy Settings - Get

Obtient les paramètres de hiérarchie définis au niveau du groupe d’administration. Les paramètres ne peuvent être définis que sur le groupe d’administration racine de la hiérarchie.

GET 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.

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

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/root/settings/default?api-version=2020-05-01

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
ErrorDetails

Détails de l’erreur.

ErrorResponse

Objet error.

HierarchySettings

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

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.