Hierarchy Settings - Create Or Update

服务:

Management Groups

API 版本:

2020-05-01

创建或更新管理组级别定义的层次结构设置。

PUT 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 Flow。

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

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

GetGroupSettings

示例请求

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

示例响应

状态代码:

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

Object

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

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

ErrorDetails

Object

错误的详细信息。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
details	string	错误详细信息的可读表示形式。
message	string	错误的人工可读表示形式。

ErrorResponse

Object

错误对象。

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

HierarchySettings

Object

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

名称	类型	说明
id	string	设置对象的完全限定 ID。 例如，/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000/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-0000000000000
type	string	资源的类型。 例如，Microsoft.Management/managementGroups/settings。