Freigeben über


alertRecord-Ressourcentyp

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
List microsoft.graph.deviceManagement.alertRecord-Sammlung Rufen Sie eine Liste der alertRecord-Objekte und deren Eigenschaften ab.
Get microsoft.graph.deviceManagement.alertRecord Liest die Eigenschaften und Beziehungen eines alertRecord-Objekts .
Abrufen von Portalbenachrichtigungen 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.
Festlegen der Portalbenachrichtigung als gesendet Keine Legen Sie den 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 Zeichenfolge 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 Zeichenfolge Der Anzeigename des Warnungsdatensatzes.
id Zeichenfolge 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 Der 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

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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