Hierarchy Settings - Create Or Update

Referencia

Service:: Management Groups

API Version:: 2020-05-01

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.

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

HTTP

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

Status code:: 200

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

Compartir a través de