Type de ressource alertRule

Article
11/18/2023

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 une règle qu’un administrateur informatique disposant des rôles appropriés peut configurer pour surveiller les problèmes et déclencher des alertes sur le centre d’administration Microsoft Endpoint Manager.

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 de Windows 365 et de 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éthode	Type de retour	Description
Lister alertRules	collection microsoft.graph.deviceManagement.alertRule	Obtenez la liste des objets alertRule et leurs propriétés.
Créer alertRule	microsoft.graph.deviceManagement.alertRule	Créez un objet alertRule .
Obtenir alertRule	microsoft.graph.deviceManagement.alertRule	Lire les propriétés et les relations d’un objet alertRule .
Mettre à jour alertRule	microsoft.graph.deviceManagement.alertRule	Mettez à jour les propriétés d’un objet alertRule .

Propriétés

Propriété	Type	Description
alertRuleTemplate	microsoft.graph.deviceManagement.alertRuleTemplate	Modèle de règle de l’événement d’alerte. Les valeurs possibles sont `cloudPcProvisionScenario`, `cloudPcImageUploadScenario`, `cloudPcOnPremiseNetworkConnectionCheckScenario`, `cloudPcInGracePeriodScenario`, `cloudPcFrontlineInsufficientLicensesScenario`, `cloudPcInaccessibleScenario`. 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`.
description	Chaîne	Description de la règle.
displayName	String	Nom d’affichage de la règle.
activé	Valeur booléenne	Status de la règle qui indique si la règle est activée ou désactivée. Si `true`la valeur est , la règle est activée ; sinon, la règle est désactivée.
id	Chaîne	Identificateur unique de la règle d’alerte. Hérité de l’entité.
isSystemRule	Valeur booléenne	Indique si la règle est une règle système. Si `true`la valeur est , la règle est une règle système ; sinon, la règle est une règle personnalisée qui peut être modifiée. Les règles système sont intégrées et seules quelques propriétés peuvent être modifiées.
notificationChannels	collection microsoft.graph.deviceManagement.notificationChannel	Canaux de notification de la règle sélectionnée par l’utilisateur.
Sévérité	microsoft.graph.deviceManagement.ruleSeverityType	Gravité de la règle. Les valeurs possibles sont : `unknown`, `informational`, `warning`, `critical`, `unknownFutureValue`.
Seuil	microsoft.graph.deviceManagement.ruleThreshold	Conditions qui déterminent quand envoyer des alertes. Par exemple, vous pouvez configurer une condition pour envoyer une alerte en cas d’échec de l’approvisionnement pour six PC cloud ou plus. Cette propriété est déconseillée. Utilisez plutôt des conditions.
conditions	collection microsoft.graph.deviceManagement.ruleCondition	Conditions qui déterminent quand envoyer des alertes. Par exemple, vous pouvez configurer une condition pour envoyer une alerte en cas d’échec de l’approvisionnement pour six PC cloud ou plus.

valeurs alertRuleTemplate

Member	Description
cloudPcProvisionScenario	La règle d’alerte a été déclenchée pour un problème avec l’approvisionnement du PC cloud. Pour une règle système, la règle d’alerte a été déclenchée en cas d’échec d’approvisionnement de PC cloud.
cloudPcImageUploadScenario	La règle d’alerte a été déclenchée pour un problème avec le processus de chargement de l’image pc cloud. Pour une règle système, la règle d’alerte a été déclenchée en cas d’échec du chargement de l’image du PC cloud.
cloudPcOnPremiseNetworkConnectionCheckScenario	La règle d’alerte a été déclenchée pour un problème avec la connexion réseau locale case activée. Pour une règle système, la règle d’alerte a été déclenchée en cas d’échec de la connexion réseau locale.
unknownFutureValue	Valeur sentinel de l’énumération évolutive. Ne pas utiliser.
cloudPcInGracePeriodScenario	La règle d’alerte a été déclenchée lorsque le PC cloud est entré dans la période de grâce.
cloudPcFrontlineInsufficientLicensesScenario	La règle d’alerte a été déclenchée pour les PC cloud de première ligne où plus de connexions pc cloud simultanées étaient actives que la limite d’accès concurrentiel autorisée.
cloudPcInaccessibleScenario	La règle d’alerte a été déclenchée lorsque les PC cloud ne pouvaient pas se connecter en raison d’une défaillance d’intégrité de l’hôte, d’erreurs de connexion ou d’une panne de zone. Sinon, parce qu’ils étaient en cours d’approvisionnement ou de restauration d’appareils status.

Valeurs ruleSeverityType

Member	Description
unknown	Le niveau de gravité est `unknown`. Utilisé pour l’initialisation.
Information	Le niveau de gravité est `informational`.
warning	Le niveau de gravité est `warning`.
Critique	Le niveau de gravité est `critical`.
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.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"
    }
  ]
}