Partager via


Type de ressource alertRecord

Espace de noms : microsoft.graph.deviceManagement

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente l’enregistrement d’un événement d’alerte dans le centre d’administration Microsoft Endpoint Manager déclenché par un objet alertRule.

Lorsque le seuil d’un objet alertRule est atteint, un alertRecord est généré et stocké, et les administrateurs reçoivent des notifications via des canaux de notification définis.

Pour plus d’informations, consultez la ressource de supervision .

Remarque

Cette API fait partie de l’ensemble d’API de surveillance des alertes qui prend actuellement en charge uniquement les scénarios Windows 365 et PC cloud. L’ensemble d’API permet aux administrateurs de configurer des règles pour alerter les problèmes liés à l’approvisionnement des PC cloud, au chargement d’images de PC cloud et à la vérification des connexions réseau Azure.

Vous avez un autre scénario qui peut utiliser une prise en charge supplémentaire des alertes par programmation dans le centre d’administration Microsoft Endpoint Manager ? Suggérer la fonctionnalité ou voter pour les demandes de fonctionnalités existantes.

Méthodes

Méthode Type de retour Description
List collection microsoft.graph.deviceManagement.alertRecord Obtenez la liste des objets alertRecord et leurs propriétés.
Obtenir microsoft.graph.deviceManagement.alertRecord Lit les propriétés et les relations d’un objet alertRecord .
Obtenir les notifications du portail collection microsoft.graph.deviceManagement.portalNotification Obtenez la liste de toutes les notifications du portail auxquelles un ou plusieurs utilisateurs peuvent accéder à partir du Centre d’administration Microsoft Endpoint Manager.
Définir la notification du portail comme envoyée Aucune Définissez l’état de la notification spécifiée dans le Centre d’administration Microsoft EndPoint Manager tel qu’il est envoyé.

Propriétés

Propriété Type Description
alertImpact microsoft.graph.deviceManagement.alertImpact Impact de l’événement d’alerte. Se compose d’une liste de paires clé-valeur et d’un nombre suivi du type d’agrégation. Par exemple, 6 affectedCloudPcCount signifie que 6 PC cloud sont affectés. 12 affectedCloudPcPercentage signifie que 12 % des PC cloud sont affectés. La liste des paires clé-valeur indique les détails de l’impact de l’alerte.
alertRuleId Chaîne ID correspondant de la règle d’alerte.
alertRuleTemplate microsoft.graph.deviceManagement.alertRuleTemplate Modèle de règle de l’événement d’alerte. Les valeurs possibles sont : cloudPcProvisionScenario, cloudPcImageUploadScenario, cloudPcOnPremiseNetworkConnectionCheckScenario, unknownFutureValue, cloudPcInGracePeriodScenario. Notez que vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes à partir de cette énumération évolutive : cloudPcInGracePeriodScenario.
detectedDateTime DateTimeOffset Date et heure de détection de l’événement d’alerte. Le type Timestamp représente les informations de date et d’heure au format ISO 8601. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
displayName Chaîne Nom complet de l’enregistrement d’alerte.
id Chaîne Identificateur unique de l’enregistrement d’alerte. Hérité de l’entité.
lastUpdatedDateTime DateTimeOffset Date et heure de la dernière mise à jour de l’enregistrement d’alerte. Le type Timestamp représente les informations de date et d’heure au format ISO 8601. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
resolvedDateTime DateTimeOffset Date et heure auxquelles l’événement d’alerte a été résolu. Le type Timestamp représente les informations de date et d’heure au format ISO 8601. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
Sévérité microsoft.graph.deviceManagement.ruleSeverityType Gravité de l’événement d’alerte. Les valeurs possibles sont : unknown, informational, warning, critical, unknownFutureValue.
status microsoft.graph.deviceManagement.alertStatusType État de l’enregistrement d’alerte. Les valeurs possibles sont active, resolved, unknownFutureValue.

Valeurs alertStatusType

Member Description
actif L’alerte est active.
résolu L’alerte est marquée comme résolue.
unknownFutureValue Valeur sentinel de l’énumération évolutive. Ne pas utiliser.

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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