Compartir a través de


Hierarchy Settings - Create Or Update

Crea o actualiza la configuración de jerarquía definida en el nivel de grupo de administración.

PUT 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

Id. de 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 grupos en el grupo raíz Grupo de administración. Si se establece en true, el usuario necesitará la acción Microsoft.Management/managementGroups/write en el ámbito del grupo de administración raíz para crear nuevos grupos directamente bajo la raíz. Esto impedirá que los nuevos usuarios creen nuevos grupos de administración, a menos que se les conceda 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

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

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 grupos en el grupo raíz Grupo de administración. Si se establece en true, el usuario necesitará la acción Microsoft.Management/managementGroups/write en el ámbito del grupo de administración raíz para crear nuevos grupos directamente bajo la raíz. Esto impedirá que los nuevos usuarios creen nuevos grupos de administración, a menos que se les conceda acceso.

ErrorDetails

Detalles del error.

Nombre Tipo Description
code

string

Uno de un conjunto definido por el servidor de códigos de error.

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 grupos en el grupo raíz Grupo de administración. Si se establece en true, el usuario necesitará la acción Microsoft.Management/managementGroups/write en el ámbito del grupo de administración raíz para crear nuevos grupos directamente bajo la raíz. Esto impedirá que los nuevos usuarios creen nuevos grupos de administración, a menos que se les conceda acceso.

properties.tenantId

string

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

type

string

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