你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Hierarchy Settings - Get
获取在管理组级别定义的层次结构设置。 只能在层次结构的根管理组上设置设置。
GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/settings/default?api-version=2020-05-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
group
|
path | True |
string |
管理组 ID。 |
api-version
|
query | True |
string |
要与客户端请求一起使用的 API 的版本。 当前版本为 2018-01-01-preview。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
确定 |
|
Other Status Codes |
错误 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
GetGroupSettings
示例请求
GET https://management.azure.com/providers/Microsoft.Management/managementGroups/root/settings/default?api-version=2020-05-01
示例响应
{
"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
}
}
定义
名称 | 说明 |
---|---|
Error |
错误的详细信息。 |
Error |
错误对象。 |
Hierarchy |
在管理组范围定义的设置。 |
ErrorDetails
错误的详细信息。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
服务器定义的一组错误代码中的一个。 |
details |
string |
错误详细信息的可读表示形式。 |
message |
string |
错误的用户可读表示形式。 |
ErrorResponse
错误对象。
名称 | 类型 | 说明 |
---|---|---|
error |
错误 |
HierarchySettings
在管理组范围定义的设置。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
设置对象的完全限定 ID。 例如,/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000/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-000000000000 |
type |
string |
资源类型。 例如,Microsoft.Management/managementGroups/settings。 |