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