Hierarchy Settings - Create Or Update

Создает или обновляет параметры иерархии, определенные на уровне группы управления.

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

Параметры URI

Name In Required Type Description
groupId
path True
  • string

Идентификатор группы управления.

api-version
query True
  • string

Версия API, используемая с клиентским запросом. Текущая версия — 2018-01-01-preview.

Текст запроса

Name Type Description
properties.defaultManagementGroup
  • string

Параметры, задающий группу управления по умолчанию, в которой добавляются новые подписки в этом клиенте. Например, /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation
  • boolean

Указывает, требуется ли доступ RBAC при создании группы в корневой группе управления. Если задано значение true, пользователю потребуется действие Microsoft.Management/managementGroups/write в области корневой группы управления, чтобы создать новые группы непосредственно под корневым элементом. Это не позволит новым пользователям создавать новые группы управления, если им не предоставлен доступ.

Ответы

Name Type Description
200 OK

ОК

Other Status Codes

Error

Безопасность

azure_auth

Azure Active Directory Flow OAuth2.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation олицетворения учетной записи пользователя

Примеры

GetGroupSettings

Sample Request

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

Sample Response

{
  "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

Параметры для создания или обновления параметров группы управления

Name Type Description
properties.defaultManagementGroup
  • string

Параметры, задающий группу управления по умолчанию, в которой добавляются новые подписки в этом клиенте. Например, /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation
  • boolean

Указывает, требуется ли доступ RBAC при создании группы в корневой группе управления. Если задано значение true, пользователю потребуется действие Microsoft.Management/managementGroups/write в области корневой группы управления, чтобы создать новые группы непосредственно под корневым элементом. Это не позволит новым пользователям создавать новые группы управления, если им не предоставлен доступ.

ErrorDetails

Сведения об ошибке.

Name Type Description
code
  • string

Один из определяемых сервером кодов ошибок.

details
  • string

Удобочитаемое представление сведений об ошибке.

message
  • string

Удобочитаемое представление ошибки.

ErrorResponse

Объект ошибки.

Name Type Description
error

Error
Сведения об ошибке.

HierarchySettings

Параметры, определенные в области группы управления.

Name Type Description
id
  • string

Полный идентификатор объекта settings. Например, /providers/Microsoft.Management/managementGroups/000000-0000-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, связанный с параметрами иерархии. Например, 00000000-0000-0000-0000-000000000000

type
  • string

Тип ресурса. Например, Microsoft.Management/managementGroups/settings.