Hierarchy Settings - List

Referencia

Servicio:: Management Groups

Versión de la API:: 2020-05-01

Obtiene toda la configuración de jerarquía definida en el nivel de 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?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.

Respuestas

Nombre	Tipo	Description
200 OK	HierarchySettingsList	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

ListGroupSettings

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "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
      }
    }
  ],
  "@nextLink": null
}

Definiciones

Nombre	Description
ErrorDetails	Detalles del error.
ErrorResponse	Objeto de error.
HierarchySettingsInfo	Recurso de configuración de jerarquía.
HierarchySettingsList	Listas todas las configuraciones de jerarquía.

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.

HierarchySettingsInfo

Recurso de configuración de jerarquía.

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.

HierarchySettingsList

Listas todas las configuraciones de jerarquía.

Nombre	Tipo	Description
@nextLink	string	Dirección URL que se va a usar para obtener el siguiente conjunto de resultados.
value	HierarchySettingsInfo[]	Lista de valores de configuración de jerarquía.

Compartir a través de