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

Hierarchy Settings - List

参考

服务:: Management Groups

API 版本:: 2020-05-01

获取在管理组级别定义的所有层次结构设置。只能在层次结构的根管理组上设置设置。

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

URI 参数

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

响应

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

安全性

azure_auth

Azure Active Directory OAuth2 流。

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

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

ListGroupSettings

示例请求

HTTP

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

示例响应

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

定义

名称	说明
ErrorDetails	错误的详细信息。
ErrorResponse	错误对象。
HierarchySettingsInfo	层次结构设置资源。
HierarchySettingsList	Lists所有层次结构设置。

ErrorDetails

错误的详细信息。

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

ErrorResponse

错误对象。

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

HierarchySettingsInfo

层次结构设置资源。

名称	类型	说明
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。

HierarchySettingsList

Lists所有层次结构设置。

名称	类型	说明
@nextLink	string	用于获取下一组结果的 URL。
value	HierarchySettingsInfo[]	层次结构设置的列表。

通过