Создание deviceManagementConfigurationCategory

Пространство имен: microsoft.graph

Важный: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Создайте объект deviceManagementConfigurationCategory .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения	Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)	DeviceManagementConfiguration.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.
Приложение	DeviceManagementConfiguration.ReadWrite.All

HTTP-запрос

POST /deviceManagement/inventoryCategories
POST /deviceManagement/complianceCategories
POST /deviceManagement/configurationCategories

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

Заголовок	Значение
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept	application/json

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

В тексте запроса укажите представление объекта deviceManagementConfigurationCategory в формате JSON.

В следующей таблице показаны свойства, необходимые при создании deviceManagementConfigurationCategory.

Свойство	Тип	Описание
id	String	Уникальный идентификатор категории.
description	String	Описание категории. Например: Display
CategoryDescription	String	Описание заголовка категории в сводке политики.
helpText	String	Текст справки категории. Укажите дополнительные сведения о категории.
name	String	Имя элемента
displayName	String	Имя категории. Например: Блокировка устройства
Платформ	deviceManagementConfigurationPlatforms	Типы платформ, которые имеют параметры в категории. Возможные значения: none. android, androidEnterprise, iOs, macOs, windows10X, windows10, aosp и Linux. Если это свойство не задано или равно none, возвращает категории на всех платформах. Поддерживает: $filters, $select. Только для чтения. Возможные значения: none, android, iOS, macOS, windows10X, windows10, linux, unknownFutureValue, androidEnterprise, aosp.
Технологии	deviceManagementConfigurationTechnologies	Типы технологий, которые имеют параметры в категории. Возможные значения: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, расширяемость, регистрация, endpointPrivilegeManagement. Если это свойство не задано или равно none, возвращает категории на всех платформах. Поддерживает: $filters, $select. Только для чтения. Возможные значения: none, , windows10XManagementmdm, configManager, appleRemoteManagement, microsoftSense, exchangeOnline, , mobileApplicationManagement, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement, unknownFutureValue, , windowsOsRecovery, . android
settingUsage	deviceManagementConfigurationSettingUsage	Указывает, что категория содержит параметры, используемые для параметров соответствия, конфигурации или повторного использования. Возможные значения: конфигурация, соответствие, reusableSetting. Каждое использование параметра имеет отдельную конечную точку API для вызова. Только для чтения. Возможные значения: none, configuration, compliance, unknownFutureValue, inventory.
parentCategoryId	String	Прямой родительский идентификатор категории. Если категория является корневым, родительский идентификатор совпадает с идентификатором.
rootCategoryId	String	Корневой идентификатор категории.
childCategoryIds	Коллекция строк	Список дочерних идентификаторов категории.

Отклик

В случае успешного 201 Created выполнения этот метод возвращает код отклика и объект deviceManagementConfigurationCategory в теле отклика.

Пример

Запрос

Ниже приведен пример запроса.

POST https://graph.microsoft.com/beta/deviceManagement/inventoryCategories
Content-type: application/json
Content-length: 523

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationCategory",
  "description": "Description value",
  "categoryDescription": "Category Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "platforms": "android",
  "technologies": "mdm",
  "settingUsage": "configuration",
  "parentCategoryId": "Parent Category Id value",
  "rootCategoryId": "Root Category Id value",
  "childCategoryIds": [
    "Child Category Ids value"
  ]
}

Отклик

Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 572

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationCategory",
  "id": "cff34dd2-4dd2-cff3-d24d-f3cfd24df3cf",
  "description": "Description value",
  "categoryDescription": "Category Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "platforms": "android",
  "technologies": "mdm",
  "settingUsage": "configuration",
  "parentCategoryId": "Parent Category Id value",
  "rootCategoryId": "Root Category Id value",
  "childCategoryIds": [
    "Child Category Ids value"
  ]
}