Type de ressource alertRule
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 | String | Description de la règle. |
displayName | String | Nom d’affichage de la règle. |
activé | Boolean | 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 | String | Identificateur unique de la règle d’alerte. Hérité de l’entité. |
isSystemRule | Boolean | 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. |
informationnel | 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"
},
"conditions": [
{
"@odata.type": "microsoft.graph.deviceManagement.ruleCondition"
}
]
}