Тип ресурса alertRule

Статья
11/18/2023

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет правило, которое ИТ-администратор с соответствующими ролями может настроить для мониторинга проблем и активации оповещений в Центре администрирования Microsoft Endpoint Manager.

При достижении порогового значения alertRule создается и сохраняется оповещениеRecord , а администраторы получают уведомления через определенные каналы уведомлений.

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

Примечание.

Этот API является частью набора API мониторинга оповещений, который в настоящее время поддерживает только сценарии Windows 365 и облачных компьютеров. Набор API позволяет администраторам настраивать правила для оповещения о проблемах с подготовкой облачных компьютеров, отправкой образов облачных компьютеров и проверкой сетевых подключений Azure.

Есть другой сценарий, в котором можно использовать дополнительную поддержку программных оповещений в Центре администрирования Microsoft Endpoint Manager? Предложите функцию или проголосуйте за существующие запросы функций.

Метод	Тип возвращаемых данных	Описание
Список оповещений	коллекция microsoft.graph.deviceManagement.alertRule	Получите список объектов alertRule и их свойств.
Создание alertRule	microsoft.graph.deviceManagement.alertRule	Создайте объект alertRule .
Получить оповещениеRule	microsoft.graph.deviceManagement.alertRule	Чтение свойств и связей объекта alertRule .
Обновление alertRule	microsoft.graph.deviceManagement.alertRule	Обновление свойств объекта alertRule .

Свойства

Свойство	Тип	Описание
alertRuleTemplate	microsoft.graph.deviceManagement.alertRuleTemplate	Шаблон правила события оповещения. Допустимые значения: `cloudPcProvisionScenario`, `cloudPcImageUploadScenario`, `cloudPcOnPremiseNetworkConnectionCheckScenario`, `cloudPcInGracePeriodScenario`, `cloudPcFrontlineInsufficientLicensesScenario`, `cloudPcInaccessibleScenario`. Обратите внимание, что необходимо использовать `Prefer: include-unknown-enum-members` заголовок запроса, чтобы получить следующие значения из этого развиваемого перечисления: `cloudPcInGracePeriodScenario`.
description	String	Описание правила.
displayName	String	Отображаемое имя правила.
включено	Логический	Состояние правила, указывающее, включено или отключено правило. Если `true`задано значение , правило включено; в противном случае правило будет отключено.
id	String	Уникальный идентификатор правила генерации оповещений. Наследуется от сущности.
isSystemRule	Логический	Указывает, является ли правило системным. Если `true`задано значение , это правило является системным правилом; в противном случае правило является настраиваемым и может быть изменено. Системные правила встроены, и изменить можно только несколько свойств.
notificationChannels	коллекция microsoft.graph.deviceManagement.notificationChannel	Каналы уведомлений правила, выбранные пользователем.
severity	microsoft.graph.deviceManagement.ruleSeverityType	Серьезность правила. Допустимые значения: `unknown`, `informational`, `warning`, `critical`, `unknownFutureValue`.
Порог	microsoft.graph.deviceManagement.ruleThreshold	Условия, определяющие время отправки оповещений. Например, можно настроить условие для отправки оповещения при сбое подготовки для шести или более облачных компьютеров. Это свойство устарело. Вместо этого используйте условия.
conditions	коллекция microsoft.graph.deviceManagement.ruleCondition	Условия, определяющие время отправки оповещений. Например, можно настроить условие для отправки оповещения при сбое подготовки для шести или более облачных компьютеров.

Значения alertRuleTemplate

Member	Описание
cloudPcProvisionScenario	Правило генерации оповещений было активировано для проблемы с подготовкой облачных компьютеров. Для системного правила правило генерации оповещений было активировано при сбое подготовки облачного компьютера.
cloudPcImageUploadScenario	Правило генерации оповещений было активировано для проблемы с процессом отправки образа облачного компьютера. Для системного правила правило генерации оповещений было активировано в случае сбоя отправки образа облачного компьютера.
cloudPcOnPremiseNetworkConnectionCheckScenario	Правило генерации оповещений было активировано для проблемы с локальным сетевым подключением проверка. Для системного правила правило генерации оповещений было активировано при сбое локального сетевого подключения.
unknownFutureValue	Изменяемое значение перечисления sentinel. Не следует использовать.
cloudPcInGracePeriodScenario	Правило генерации оповещений активировалось, когда облачный компьютер вступил в льготный период.
cloudPcFrontlineInsufficientLicensesScenario	Правило генерации оповещений было активировано для облачных компьютеров Frontline, на которых было активно больше одновременных подключений к облачным компьютерам, чем позволяет ограничение параллелизма.
cloudPcInaccessibleScenario	Правило генерации оповещений активировалось, когда облачным компьютерам не удалось подключиться из-за сбоя работоспособности узла, ошибок подключения или сбоя зоны. Кроме того, они находились в состоянии подготовки или восстановления состояния устройства.

Значения ruleSeverityType

Member	Описание
unknown	Уровень серьезности — `unknown`. Используется для инициализации.
Информационных	Уровень серьезности — `informational`.
warning	Уровень серьезности — `warning`.
Критических	Уровень серьезности — `critical`.
unknownFutureValue	Изменяемое значение перечисления sentinel. Не следует использовать.

Связи

Отсутствуют.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "@odata.type": "#microsoft.graph.deviceManagement.alertRule",
  "alertRuleTemplate": "String",  
  "description": "String",
  "displayName": "String",
  "enabled": "Boolean",
  "id": "String (identifier)",
  "isSystemRule": "Boolean",
  "notificationChannels": [
    {
      "@odata.type": "microsoft.graph.deviceManagement.notificationChannel"
    }
  ], 
  "severity": "String",
  "threshold": {
    "@odata.type": "microsoft.graph.deviceManagement.ruleThreshold"
  },
  "condition": [
    {
      "@odata.type": "microsoft.graph.deviceManagement.ruleCondition"
    }
  ]
}