Hierarchy Settings - Create Or Update

Ссылка

Service:: Management Groups

API Version:: 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.

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

Scopes

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

GetGroupSettings

Sample Request

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

Sample Response

Status code:: 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

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

Имя	Тип	Описание
properties.defaultManagementGroup	string	Параметры, определяющие группу управления по умолчанию, в которой добавляются новые подписки в этом клиенте. Например, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Указывает, требуется ли доступ к RBAC при создании группы в корневой группе управления. Если задано значение true, пользователю потребуется действие Microsoft.Management/managementGroups/write в корневой группе управления область, чтобы создать новые группы непосредственно под корнем. Это не позволит новым пользователям создавать новые группы управления, если им не предоставлен доступ.

ErrorDetails

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

Имя	Тип	Описание
code	string	Один из серверных наборов кодов ошибок.
details	string	Понятное представление сведений об ошибке.
message	string	Понятное представление ошибки.

ErrorResponse

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

Имя	Тип	Описание
error	ErrorDetails	Ошибка Сведения об ошибке.

HierarchySettings

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

Имя	Тип	Описание
id	string	Полный идентификатор объекта settings. Например, /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, связанный с параметрами иерархии. Например, 0000000-0000-0000-0000-00000000000000
type	string	Тип ресурса. Например, Microsoft.Management/managementGroups/settings.