alertRecord-Ressourcentyp

Artikel
08/11/2023

Namespace: microsoft.graph.deviceManagement

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt den Datensatz eines Warnungsereignisses im Microsoft Endpoint Manager Admin Center dar, das von einer alertRule ausgelöst wird.

Wenn der Schwellenwert einer alertRule erreicht wird, wird ein alertRecord generiert und gespeichert, und Administratoren erhalten Benachrichtigungen über definierte Benachrichtigungskanäle.

Weitere Informationen finden Sie in der Überwachungsressource .

Hinweis

Diese API ist Teil des API-Satzes für die Warnungsüberwachung, der derzeit nur Windows 365- und Cloud-PC-Szenarien unterstützt. Mit dem API-Satz können Administratoren Regeln einrichten, um Probleme bei der Bereitstellung von Cloud-PCs, dem Hochladen von Cloud-PC-Images und dem Überprüfen von Azure-Netzwerkverbindungen zu warnen.

Haben Sie ein anderes Szenario, das zusätzliche programmgesteuerte Warnungsunterstützung im Microsoft Endpoint Manager Admin Center verwenden kann? Schlagen Sie das Feature vor oder stimmen Sie für vorhandene Featureanforderungen ab.

Methoden

Methode	Rückgabetyp	Beschreibung
WarnungauflistenDatensätze	microsoft.graph.deviceManagement.alertRecord-Sammlung	Rufen Sie eine Liste der alertRecord-Objekte und deren Eigenschaften ab.
Warnung abrufenDatensatz	microsoft.graph.deviceManagement.alertRecord	Liest die Eigenschaften und Beziehungen eines alertRecord-Objekts .
getPortalNotifications	microsoft.graph.deviceManagement.portalNotification-Sammlung	Rufen Sie eine Liste aller Portalbenachrichtigungen ab, auf die ein oder mehrere Benutzer zugreifen können, aus dem Microsoft Endpoint Manager Admin Center.
setPortalNotificationAsSent	Keine	Legen Sie die status der angegebenen Benachrichtigung im Microsoft EndPoint Manager Admin Center als gesendet fest.

Eigenschaften

Eigenschaft	Typ	Beschreibung
alertImpact	microsoft.graph.deviceManagement.alertImpact	Die Auswirkung des Warnungsereignisses. Besteht aus einer Liste von Schlüssel-Wert-Paaren und einer Zahl gefolgt vom Aggregationstyp. Bedeutet beispielsweise, `6 affectedCloudPcCount` dass 6 Cloud-PCs betroffen sind. `12 affectedCloudPcPercentage` bedeutet, dass 12 % der Cloud-PCs betroffen sind. Die Liste der Schlüssel-Wert-Paare gibt die Details der Warnungsauswirkungen an.
alertRuleId	String	Die entsprechende ID der Warnungsregel.
alertRuleTemplate	microsoft.graph.deviceManagement.alertRuleTemplate	Die Regelvorlage des Warnungsereignisses. Mögliche Werte sind: `cloudPcProvisionScenario`, `cloudPcImageUploadScenario`, `cloudPcOnPremiseNetworkConnectionCheckScenario`, `unknownFutureValue`, `cloudPcInGracePeriodScenario`. Beachten Sie, dass Sie den Anforderungsheader `Prefer: include-unknown-enum-members` verwenden müssen, um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: `cloudPcInGracePeriodScenario`.
detectedDateTime	DateTimeOffset	Das Datum und die Uhrzeit der Erkennung des Warnungsereignisses. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist `2014-01-01T00:00:00Z`.
displayName	String	Der Anzeigename des Warnungsdatensatzes.
id	String	Der eindeutige Bezeichner für den Warnungsdatensatz. Geerbt von entity.
lastUpdatedDateTime	DateTimeOffset	Das Datum und die Uhrzeit der letzten Aktualisierung des Warnungsdatensatzes. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist `2014-01-01T00:00:00Z`.
resolvedDateTime	DateTimeOffset	Das Datum und die Uhrzeit der Auflösung des Warnungsereignisses. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist `2014-01-01T00:00:00Z`.
Schweregrad	microsoft.graph.deviceManagement.ruleSeverityType	Der Schweregrad des Warnungsereignisses. Mögliche Werte sind: `unknown`, `informational`, `warning`, `critical`, `unknownFutureValue`.
status	microsoft.graph.deviceManagement.alertStatusType	Die status des Warnungsdatensatzes. Die möglichen Werte sind: `active`, `resolved`, `unknownFutureValue`.

alertStatusType-Werte

Member	Beschreibung
aktiv	Die Warnung ist aktiv.
resolved	Die Warnung ist als gelöst gekennzeichnet.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

Beziehungen

Keine.

JSON-Darstellung

Es folgt eine JSON-Darstellung der 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"
}

Share via