Создание appVulnerabilityTask

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

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

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

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

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

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

Разрешения

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

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

HTTP-запрос

POST /deviceAppManagement/deviceAppManagementTasks

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

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

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

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

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

Свойство	Тип	Описание
id	String	Ключ сущности. Наследуется от deviceAppManagementTask
displayName	String	Имя. Наследуется от deviceAppManagementTask
description	String	Описание. Наследуется от deviceAppManagementTask
createdDateTime	DateTimeOffset	Дата создания. Наследуется от deviceAppManagementTask
dueDateTime	DateTimeOffset	Дата выполнения. Наследуется от deviceAppManagementTask
category	deviceAppManagementTaskCategory	Категория. Наследуется от deviceAppManagementTask. Возможные значения: unknown, advancedThreatProtection.
priority	deviceAppManagementTaskPriority	Приоритет. Наследуется от deviceAppManagementTask. Возможные значения: none, high, low.
creator	String	Адрес электронной почты создателя. Наследуется от deviceAppManagementTask
creatorNotes	String	Заметки от создателя. Наследуется от deviceAppManagementTask
assignedTo	String	Имя или адрес электронной почты администратора, которому назначена эта задача. Наследуется от deviceAppManagementTask
status	deviceAppManagementTaskStatus	Состояние. Наследуется от deviceAppManagementTask. Возможные значения: unknown, pending, active, completed, rejected.
appName	String	Имя приложения.
appPublisher	String	Издатель приложения.
appVersion	String	Версия приложения.
MitigationType	appVulnerabilityTaskMitigationType	Тип устранения рисков. Возможные значения: unknown, update, uninstall, securityConfiguration.
insights	String	Сведения о мерах по устранению рисков.
managedDeviceCount	Int32	Количество уязвимых устройств.
mobileAppCount	Int32	Количество уязвимых мобильных приложений.
Исправления	String	Шаги по исправлению.

Отклик

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

Пример

Запрос

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

POST https://graph.microsoft.com/beta/deviceAppManagement/deviceAppManagementTasks
Content-type: application/json
Content-length: 665

{
  "@odata.type": "#microsoft.graph.appVulnerabilityTask",
  "displayName": "Display Name value",
  "description": "Description value",
  "dueDateTime": "2017-01-01T00:02:18.1994089-08:00",
  "category": "advancedThreatProtection",
  "priority": "high",
  "creator": "Creator value",
  "creatorNotes": "Creator Notes value",
  "assignedTo": "Assigned To value",
  "status": "pending",
  "appName": "App Name value",
  "appPublisher": "App Publisher value",
  "appVersion": "App Version value",
  "mitigationType": "update",
  "insights": "Insights value",
  "managedDeviceCount": 2,
  "mobileAppCount": 14,
  "remediation": "Remediation value"
}

Отклик

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

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

{
  "@odata.type": "#microsoft.graph.appVulnerabilityTask",
  "id": "5b2caf2d-af2d-5b2c-2daf-2c5b2daf2c5b",
  "displayName": "Display Name value",
  "description": "Description value",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "dueDateTime": "2017-01-01T00:02:18.1994089-08:00",
  "category": "advancedThreatProtection",
  "priority": "high",
  "creator": "Creator value",
  "creatorNotes": "Creator Notes value",
  "assignedTo": "Assigned To value",
  "status": "pending",
  "appName": "App Name value",
  "appPublisher": "App Publisher value",
  "appVersion": "App Version value",
  "mitigationType": "update",
  "insights": "Insights value",
  "managedDeviceCount": 2,
  "mobileAppCount": 14,
  "remediation": "Remediation value"
}