tipo de recurso alertRecord

Artículo
08/11/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 el registro de un evento de alerta en el Centro de administración de Microsoft Endpoint Manager desencadenado por una alertRule.

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étodos

Método	Tipo devuelto	Descripción
Enumerar alertRecords	Colección microsoft.graph.deviceManagement.alertRecord	Obtenga una lista de los objetos alertRecord y sus propiedades.
Obtener alertRecord	microsoft.graph.deviceManagement.alertRecord	Lea las propiedades y relaciones de un objeto alertRecord .
getPortalNotifications	Colección microsoft.graph.deviceManagement.portalNotification	Obtenga una lista de todas las notificaciones del portal a las que pueden acceder uno o varios usuarios desde el Centro de administración de Microsoft Endpoint Manager.
setPortalNotificationAsSent	Ninguno	Establezca el estado de la notificación especificada en el Centro de administración de Microsoft EndPoint Manager como enviado.

Propiedades

Propiedad	Tipo	Descripción
alertImpact	microsoft.graph.deviceManagement.alertImpact	Impacto del evento de alerta. Consta de una lista de pares clave-valor y un número seguido del tipo de agregación. Por ejemplo, `6 affectedCloudPcCount` significa que 6 equipos en la nube se ven afectados. `12 affectedCloudPcPercentage` significa que el 12 % de los equipos en la nube se ven afectados. La lista de pares clave-valor indica los detalles del impacto de la alerta.
alertRuleId	Cadena	Identificador correspondiente de la regla de alertas.
alertRuleTemplate	microsoft.graph.deviceManagement.alertRuleTemplate	Plantilla de regla del evento de alerta. Los valores posibles son: `cloudPcProvisionScenario`, `cloudPcImageUploadScenario`, `cloudPcOnPremiseNetworkConnectionCheckScenario`, `unknownFutureValue`, `cloudPcInGracePeriodScenario`. 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`.
detectedDateTime	DateTimeOffset	Fecha y hora en que se detectó el evento de alerta. El tipo Timestamp representa la información de fecha y hora con el formato ISO 8601. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería `2014-01-01T00:00:00Z`.
displayName	Cadena	Nombre para mostrar del registro de alerta.
id	Cadena	Identificador único del registro de alertas. Heredado de la entidad.
lastUpdatedDateTime	DateTimeOffset	Fecha y hora en que se actualizó por última vez el registro de alerta. El tipo Timestamp representa la información de fecha y hora con el formato ISO 8601. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería `2014-01-01T00:00:00Z`.
resolvedDateTime	DateTimeOffset	Fecha y hora en que se resolvió el evento de alerta. El tipo Timestamp representa la información de fecha y hora con el formato ISO 8601. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería `2014-01-01T00:00:00Z`.
severity	microsoft.graph.deviceManagement.ruleSeverityType	Gravedad del evento de alerta. Los valores posibles son: `unknown`, `informational`, `warning`, `critical`, `unknownFutureValue`.
status	microsoft.graph.deviceManagement.alertStatusType	Estado del registro de alerta. Los valores posibles son: `active`, `resolved`, `unknownFutureValue`.

valores alertStatusType

Member	Descripción
Activo	La alerta está activa.
resolved	La alerta se marca como resuelta.
unknownFutureValue	Valor de sentinel de enumeración evolvable. No usar.

Relaciones

Ninguna.

Representación JSON

La siguiente es una representación JSON del recurso

{
  "@odata.type": "#microsoft.graph.deviceManagement.alertRecord",
  "alertImpact": {
    "@odata.type": "microsoft.graph.deviceManagement.alertImpact"
  },  
  "alertRuleId": "String",
  "alertRuleTemplate": "String",
  "detectedDateTime": "String (timestamp)",
  "displayName": "String",
  "id": "String (identifier)",
  "lastUpdatedDateTime": "String (timestamp)",
  "resolvedDateTime": "String (timestamp)",
  "severity": "String",
  "status": "String"
}