你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Hierarchy Settings - Update

参考

服务:: Management Groups

API 版本:: 2020-05-01

汇报在管理组级别定义的层次结构设置。

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

URI 参数

名称	在	必需	类型	说明
groupId	path	True	string	管理组 ID。
api-version	query	True	string	要与客户端请求一起使用的 API 的版本。当前版本为 2018-01-01-preview。

请求正文

名称	类型	说明
properties.defaultManagementGroup	string	设置在此租户中添加新订阅的默认管理组的设置。例如，/providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	指示在根管理组下创建组时是否需要 RBAC 访问权限。如果设置为 true，用户需要对根管理组范围执行 Microsoft.Management/managementGroups/write 操作，以便直接在根目录下创建新组。这将阻止新用户创建新的管理组，除非他们被授予访问权限。

响应

名称	类型	说明
200 OK	HierarchySettings	确定
Other Status Codes	ErrorResponse	错误

安全性

azure_auth

Azure Active Directory OAuth2 流。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

GetGroupSettings

示例请求

HTTP

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

示例响应

状态代码:: 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
  }
}

定义

名称	说明
CreateOrUpdateSettingsRequest	用于创建或更新管理组设置的参数
ErrorDetails	错误的详细信息。
ErrorResponse	错误对象。
HierarchySettings	在管理组范围内定义的设置。

CreateOrUpdateSettingsRequest

用于创建或更新管理组设置的参数

名称	类型	说明
properties.defaultManagementGroup	string	设置在此租户中添加新订阅的默认管理组的设置。例如，/providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	指示在根管理组下创建组时是否需要 RBAC 访问权限。如果设置为 true，用户需要对根管理组范围执行 Microsoft.Management/managementGroups/write 操作，以便直接在根目录下创建新组。这将阻止新用户创建新的管理组，除非他们被授予访问权限。

ErrorDetails

错误的详细信息。

名称	类型	说明
code	string	服务器定义的一组错误代码中的一个。
details	string	错误详细信息的可读表示形式。
message	string	错误的用户可读表示形式。

ErrorResponse

错误对象。

名称	类型	说明
error	ErrorDetails	错误错误的详细信息。

HierarchySettings

在管理组范围内定义的设置。

名称	类型	说明
id	string	设置对象的完全限定 ID。例如，/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000000000000/settings/default。
name	string	对象的名称。在这种情况下，默认值为。
properties.defaultManagementGroup	string	设置在此租户中添加新订阅的默认管理组的设置。例如，/providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	指示在根管理组下创建组时是否需要 RBAC 访问权限。如果设置为 true，用户需要对根管理组范围执行 Microsoft.Management/managementGroups/write 操作，以便直接在根目录下创建新组。这将阻止新用户创建新的管理组，除非他们被授予访问权限。
properties.tenantId	string	与层次结构设置关联的 AAD 租户 ID。例如，00000000-0000-0000-0000-00000000000000
type	string	资源类型。例如，Microsoft.Management/managementGroups/settings。

通过