Compartir a través de


Hierarchy Settings - Update

Novedades la configuración de jerarquía definida en el nivel grupo de administración.

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

Cuerpo de la solicitud

Nombre Tipo Description
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.

Respuestas

Nombre Tipo Description
200 OK

HierarchySettings

Aceptar

Other Status Codes

ErrorResponse

Error

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

GetGroupSettings

Solicitud de ejemplo

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

Respuesta de muestra

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

Parámetros para crear o actualizar la configuración del grupo de administración

ErrorDetails

Detalles del error.

ErrorResponse

Objeto de error.

HierarchySettings

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

CreateOrUpdateSettingsRequest

Parámetros para crear o actualizar la configuración del grupo de administración

Nombre Tipo Description
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.

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.