tipo de recurso alertRule

Artículo
11/18/2023

Espacio de nombres: microsoft.graph.deviceManagement

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa una regla que un administrador de TI con los roles adecuados puede configurar para supervisar problemas y desencadenar alertas en el Centro de administración de Microsoft Endpoint Manager.

Cuando se alcanza el umbral de una alertRule , se genera y almacena un alertRecord y los administradores reciben notificaciones a través de canales de notificación definidos.

Para obtener más información, consulte el recurso de supervisión .

Nota:

Esta API forma parte del conjunto de API de supervisión de alertas, que actualmente solo admite escenarios de Windows 365 y pc en la nube. El conjunto de API permite a los administradores configurar reglas para alertar de problemas con el aprovisionamiento de equipos en la nube, la carga de imágenes de PC en la nube y la comprobación de las conexiones de red de Azure.

¿Tiene otro escenario que pueda usar la compatibilidad adicional con alertas mediante programación en el Centro de administración de Microsoft Endpoint Manager? Sugiera la característica o vote por las solicitudes de características existentes.

Método	Tipo devuelto	Descripción
Enumerar alertRules	Colección microsoft.graph.deviceManagement.alertRule	Obtenga una lista de los objetos alertRule y sus propiedades.
Creación de alertRule	microsoft.graph.deviceManagement.alertRule	Cree un objeto alertRule .
Obtener alertRule	microsoft.graph.deviceManagement.alertRule	Lea las propiedades y relaciones de un objeto alertRule .
Actualizar alertRule	microsoft.graph.deviceManagement.alertRule	Actualice las propiedades de un objeto alertRule .

Propiedades

Propiedad	Tipo	Descripción
alertRuleTemplate	microsoft.graph.deviceManagement.alertRuleTemplate	Plantilla de regla del evento de alerta. Los valores posibles son: `cloudPcProvisionScenario`, `cloudPcImageUploadScenario`, `cloudPcOnPremiseNetworkConnectionCheckScenario`, `cloudPcInGracePeriodScenario`, `cloudPcFrontlineInsufficientLicensesScenario`, `cloudPcInaccessibleScenario`. Tenga en cuenta que debe usar el encabezado de `Prefer: include-unknown-enum-members` solicitud para obtener los siguientes valores de esta enumeración evolvable: `cloudPcInGracePeriodScenario`.
description	Cadena	Descripción de la regla.
displayName	String	Nombre para mostrar de la regla.
habilitado	Booleano	Estado de la regla que indica si la regla está habilitada o deshabilitada. Si `true`es , la regla está habilitada; de lo contrario, la regla está deshabilitada.
id	Cadena	Identificador único de la regla de alertas. Heredado de la entidad.
isSystemRule	Booleano	Indica si la regla es una regla del sistema. Si `true`es , la regla es una regla del sistema; de lo contrario, la regla es una regla definida personalizada y se puede editar. Las reglas del sistema están integradas y solo se pueden editar algunas propiedades.
notificationChannels	Colección microsoft.graph.deviceManagement.notificationChannel	Canales de notificación de la regla seleccionada por el usuario.
severity	microsoft.graph.deviceManagement.ruleSeverityType	Gravedad de la regla. Los valores posibles son: `unknown`, `informational`, `warning`, `critical`, `unknownFutureValue`.
Umbral	microsoft.graph.deviceManagement.ruleThreshold	Condiciones que determinan cuándo enviar alertas. Por ejemplo, puede configurar una condición para enviar una alerta cuando se produce un error en el aprovisionamiento de seis o más equipos en la nube. Esta propiedad está en desuso. Use condiciones en su lugar.
conditions	Colección microsoft.graph.deviceManagement.ruleCondition	Condiciones que determinan cuándo enviar alertas. Por ejemplo, puede configurar una condición para enviar una alerta cuando se produce un error en el aprovisionamiento de seis o más equipos en la nube.

valores alertRuleTemplate

Member	Descripción
cloudPcProvisionScenario	La regla de alertas se desencadenó para un problema con el aprovisionamiento del equipo en la nube. En el caso de una regla del sistema, la regla de alerta se desencadenó para un error de aprovisionamiento de equipos en la nube.
cloudPcImageUploadScenario	La regla de alertas se desencadenó para un problema con el proceso de carga de la imagen del equipo en la nube. En el caso de una regla del sistema, la regla de alerta se desencadenó por un error al cargar la imagen del equipo en la nube.
cloudPcOnPremiseNetworkConnectionCheckScenario	La regla de alerta se desencadenó para un problema con la comprobación de la conexión de red local. En el caso de una regla del sistema, la regla de alerta se desencadenó por un error con la conexión de red local.
unknownFutureValue	Valor de sentinel de enumeración evolvable. No usar.
cloudPcInGracePeriodScenario	La regla de alerta se desencadenó cuando el equipo en la nube entró en el período de gracia.
cloudPcFrontlineInsufficientLicensesScenario	La regla de alertas se desencadenó para los equipos de frontline cloud en los que estaban activas más conexiones simultáneas de pc en la nube de las que permite el límite de simultaneidad.
cloudPcInaccessibleScenario	La regla de alerta se desencadenó cuando los equipos en la nube no se pudieron conectar debido a un error de estado del host, errores de conexión o una interrupción de zona. Como alternativa, porque estaban bajo aprovisionamiento o restaurando el estado del dispositivo.

valores ruleSeverityType

Member	Descripción
desconocido	El nivel de gravedad es `unknown`. Se usa para la inicialización.
Informativo	El nivel de gravedad es `informational`.
warning	El nivel de gravedad es `warning`.
Crítico	El nivel de gravedad es `critical`.
unknownFutureValue	Valor de sentinel de enumeración evolvable. No usar.

Relaciones

Ninguna.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@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"
    }
  ]
}