Management Groups - Create Or Update

Ссылка

Service:: Management Groups

API Version:: 2020-05-01

Создание или обновление группы управления. Если группа управления уже создана и последующий запрос на создание отправляется с другими свойствами, свойства группы управления будут обновлены.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
groupId	path	True	string	Идентификатор группы управления.
api-version	query	True	string	Версия API для использования с клиентским запросом. Текущая версия — 2018-01-01-preview.

Заголовок запроса

Имя	Обязательно	Тип	Описание
Cache-Control		string	Указывает, что запрос не должен использовать кэши.

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

Имя	Тип	Описание
name	string	Имя группы управления. Например, 0000000-0000-0000-0000-00000000000000
properties.details	CreateManagementGroupDetails	Сведения Сведения о группе управления, используемой во время создания.
properties.displayName	string	Понятное имя группы управления. Если значение не передается, для этого поля будет задано значение groupId.

Ответы

Имя	Тип	Описание
200 OK	ManagementGroup	ОК
202 Accepted	AzureAsyncOperationResults	Принято Headers Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Ошибка

Имя

Тип

Описание

200 OK

ManagementGroup

ОК

202 Accepted

AzureAsyncOperationResults

Принято

Headers

Location: string
Azure-AsyncOperation: string

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	олицетворения учетной записи пользователя

Примеры

PutManagementGroup

Sample Request

HTTP

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/ChildGroup?api-version=2020-05-01


{
  "properties": {
    "displayName": "ChildGroup",
    "details": {
      "parent": {
        "id": "/providers/Microsoft.Management/managementGroups/RootGroup"
      }
    }
  }
}

Sample Response

Status code:: 200

{
  "id": "/providers/Microsoft.Management/managementGroups/ChildGroup",
  "type": "Microsoft.Management/managementGroups",
  "name": "ChildGroup",
  "properties": {
    "tenantId": "20000000-0000-0000-0000-000000000000",
    "displayName": "ChildGroup",
    "details": {
      "version": 1,
      "updatedTime": "2018-01-01T00:00:00.00Z",
      "updatedBy": "16b8ef21-5c9f-420c-bcc9-e4f8c9f30b4b",
      "parent": {
        "id": "/providers/Microsoft.Management/managementGroups/RootGroup",
        "name": "RootGroup",
        "displayName": "RootGroup"
      }
    }
  }
}

Status code:: 202

{
  "id": "/providers/Microsoft.Management/managementGroups/ChildGroup",
  "type": "Microsoft.Management/managementGroups",
  "name": "ChildGroup",
  "status": "NotStarted"
}

Определения

Имя	Описание
AzureAsyncOperationResults	Результаты Azure-AsyncOperation.
CreateManagementGroupChildInfo	Дочерние сведения группы управления, используемые во время создания.
CreateManagementGroupDetails	Сведения о группе управления, используемой во время создания.
CreateManagementGroupRequest	Параметры создания группы управления.
CreateParentGroupInfo	(Необязательно) Идентификатор родительской группы управления, используемой во время создания.
ErrorDetails	Сведения об ошибке.
ErrorResponse	Объект ошибки.
ManagementGroup	Сведения о группе управления.
ManagementGroupChildInfo	Дочерние сведения группы управления.
ManagementGroupChildType	Тип дочернего ресурса.
ManagementGroupDetails	Сведения о группе управления.
ManagementGroupPathElement	Элемент пути предков группы управления.
ParentGroupInfo	(Необязательно) Идентификатор родительской группы управления.

AzureAsyncOperationResults

Результаты Azure-AsyncOperation.

Имя	Тип	Описание
id	string	Полный идентификатор группы управления. Например, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Имя группы управления. Например, 0000000-0000-0000-0000-00000000000000
properties.displayName	string	Понятное имя группы управления.
properties.tenantId	string	Идентификатор клиента AAD, связанный с группой управления. Например, 0000000-0000-0000-0000-00000000000000
status	string	Текущее состояние выполненной асинхронной операции . Например, "Выполняется", "Успешно", "Сбой"
type	string	Тип ресурса. Например, Microsoft.Management/managementGroups

CreateManagementGroupChildInfo

Дочерние сведения группы управления, используемые во время создания.

Имя	Тип	Описание
children	CreateManagementGroupChildInfo[]	Список дочерних элементов.
displayName	string	Понятное имя дочернего ресурса.
id	string	Полный идентификатор дочернего ресурса (группы управления или подписки). Например, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Имя дочерней сущности.
type	ManagementGroupChildType	Тип дочернего ресурса. Полный тип ресурса, включающий пространство имен поставщика (например, Microsoft.Management/managementGroups).

CreateManagementGroupDetails

Сведения о группе управления, используемой во время создания.

Имя	Тип	Описание
parent	CreateParentGroupInfo	Parent (Необязательно) Идентификатор родительской группы управления, используемой во время создания.
updatedBy	string	Удостоверение субъекта или процесса, которые обновили объект.
updatedTime	string	Дата и время последнего обновления этого объекта.
version	number	Номер версии объекта.

CreateManagementGroupRequest

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

Имя	Тип	Описание
id	string	Полный идентификатор группы управления. Например, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Имя группы управления. Например, 0000000-0000-0000-0000-00000000000000
properties.children	CreateManagementGroupChildInfo[]	Список дочерних элементов.
properties.details	CreateManagementGroupDetails	Сведения Сведения о группе управления, используемой во время создания.
properties.displayName	string	Понятное имя группы управления. Если значение не передается, для этого поля будет задано значение groupId.
properties.tenantId	string	Идентификатор клиента AAD, связанный с группой управления. Например, 0000000-0000-0000-0000-00000000000000
type	string	Тип ресурса. Например, Microsoft.Management/managementGroups

CreateParentGroupInfo

(Необязательно) Идентификатор родительской группы управления, используемой во время создания.

Имя	Тип	Описание
displayName	string	Понятное имя родительской группы управления.
id	string	Полный идентификатор родительской группы управления. Например, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Имя родительской группы управления

ErrorDetails

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

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

ErrorResponse

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

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