Compartir a través de


Hierarchy Settings - Get

Obtiene la configuración de jerarquía definida en el nivel grupo de administración. La configuración solo se puede establecer en el grupo de administración raíz de la jerarquía.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
groupId
path True

string

Identificador del grupo de administración.

api-version
query True

string

Versión de la API que se va a usar con la solicitud de cliente. La versión actual es 2018-01-01-preview.

Respuestas

Nombre Tipo Description
200 OK

HierarchySettings

Aceptar

Other Status Codes

ErrorResponse

Error

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

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

Scopes

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

GetGroupSettings

Sample Request

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

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

Definiciones

Nombre Description
ErrorDetails

Detalles del error.

ErrorResponse

Objeto de error.

HierarchySettings

Configuración definida en el ámbito del grupo de administración.

ErrorDetails

Detalles del error.

Nombre Tipo Description
code

string

Uno de los conjuntos de códigos de error definidos por el servidor.

details

string

Representación legible de los detalles del error.

message

string

Representación legible del error.

ErrorResponse

Objeto de error.

Nombre Tipo Description
error

ErrorDetails

Error
Detalles del error.

HierarchySettings

Configuración definida en el ámbito del grupo de administración.

Nombre Tipo Description
id

string

Identificador completo del objeto de configuración. Por ejemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000/settings/default.

name

string

El nombre del objeto. En este caso, el valor predeterminado.

properties.defaultManagementGroup

string

Configuración que establece el grupo de administración predeterminado en el que se agregan nuevas suscripciones en este inquilino. Por ejemplo, /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation

boolean

Indica si se requiere acceso RBAC al crear el grupo en el grupo de administración raíz. Si se establece en true, el usuario requerirá la acción Microsoft.Management/managementGroups/write en el ámbito del grupo de administración raíz para crear nuevos grupos directamente en la raíz. Esto impedirá que los nuevos usuarios creen nuevos grupos de administración, a menos que se les conste acceso.

properties.tenantId

string

Identificador de inquilino de AAD asociado a la configuración de la jerarquía. Por ejemplo, 00000000-0000-0000-0000-00000000000000

type

string

Tipo de recurso. Por ejemplo, Microsoft.Management/managementGroups/settings.