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	Идентификатор группы управления.
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

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: 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	Полный идентификатор объекта settings. Например, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000/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-00000000000000000
type	string	Тип ресурса. Например, Microsoft.Management/managementGroups/settings.