configurationMonitor-Ressourcentyp

Namespace: microsoft.graph

Stellt Monitore für die Mandanten- oder Driftüberwachung für alle Workloads dar, die von der Mandantenkonfigurationsverwaltung unterstützt werden, und ermöglicht die regelmäßige Erkennung von Abweichungen vom gewünschten Konfigurationszustand.

Erbt von entity.

Methoden

Methode Rückgabetyp Beschreibung
List configurationMonitor-Sammlung Rufen Sie eine Liste der configurationMonitor-Objekte und deren Eigenschaften ab.
Create configurationMonitor Erstellen Sie ein neues configurationMonitor-Objekt , das regelmäßig im Hintergrund mit einer geplanten Häufigkeit ausgeführt wird.
Get configurationMonitor Ruft die Eigenschaften und Beziehungen eines configurationMonitor-Objekts ab.
Update configurationMonitor Aktualisieren Sie die Eigenschaften eines configurationMonitor-Objekts , einschließlich Monitorname, Beschreibung und Baseline.
Löschen Keine Löschen Sie ein configurationMonitor-Objekt dauerhaft.
Abrufen der Konfigurationsbaseline configurationBaseline-Sammlung Lesen sie die Eigenschaften und Beziehungen eines configurationBaseline-Objekts , das an einen bestimmten Monitor angefügt ist.

Eigenschaften

Eigenschaft Typ Beschreibung
createdBy identitySet Der Benutzer, die App oder das Gerät, das den Monitor erstellt hat.

Erfordert $select den Abruf. Unterstützt $filter (eq).
createdDateTime DateTimeOffset Das Datum und die Uhrzeit der Erstellung des Monitors. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.

Unterstützt $filter (eq, ne, ge, le) und $orderby.
description Zeichenfolge Benutzerfreundliche Beschreibung des vom Benutzer angegebenen Monitors.

Unterstützt $filter (eq, ne, startsWith) und $orderby.
displayName Zeichenfolge Benutzerfreundlicher Name, der vom Benutzer für den Monitor angegeben wird.

Unterstützt $filter (eq, ne, startsWith) und $orderby.
id Zeichenfolge GUID (Globally Unique Identifier) für den Monitor. Vom System generiert. Geerbt von entity.

Unterstützt $filter (eq, ne) und $orderby.
inactivationReason Zeichenfolge Der Grund für die Deaktivierung des Monitors.

Erfordert $select den Abruf.
lastModifiedBy identitySet Der Benutzer, die App oder das Gerät, das den Monitor zuletzt geändert hat.

Erfordert $select den Abruf. Unterstützt $filter (eq).
lastModifiedDateTime DateTimeOffset Datum und Uhrzeit der letzten Änderung des Monitors. Wenn keine Änderungen am Monitor vorgenommen werden, ist dies identisch mit createdDateTime. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.

Unterstützt $filter (eq, ne, ge, le) und $orderby.
mode monitorMode Überwachungsmodus, in dem der Monitor ausgeführt wird. Die möglichen Werte sind: monitorOnly, unknownFutureValue. Der Standardwert ist monitorOnly.

Unterstützt $filter (eq, ne).
monitorRunFrequencyInHours Int32 Häufigkeit, mit der der Monitor ausgeführt wird. Die Standardhäufigkeit beträgt sechs Stunden. Unabhängig davon, wann Sie einen Monitor erstellen oder aktualisieren, wird er innerhalb der nächsten 6 Stunden ausgelöst. Derzeit werden Monitore zu festen Zeiten abgeholt: 6:00 Uhr, 12:00 Uhr, 18:00 Uhr und 12:00 Uhr (alle in GMT). Wenn Sie beispielsweise einen Monitor um 9:00 Uhr erstellen, wird er gegen 12:00 Uhr ausgelöst. Wenn Sie einen Monitor um 16:00 Uhr aktualisieren, wird er gegen 18:00 Uhr ausgelöst.
Parameter openComplexDictionaryType Schlüssel-Wert-Paare, die Parameterwerte enthalten, die in der Baseline verwendet werden können.

Erfordert $select den Abruf.
status monitorStatus Status des Monitors. Die möglichen Werte sind: active, inactive, unknownFutureValue. Der Standardwert ist active.

Unterstützt $filter (eq, ne) und $orderby.
tenantId Zeichenfolge GuiD (Globally Unique Identifier) des Mandanten, für den der Monitor ausgeführt wird. Wird automatisch vom System abgerufen.

Unterstützt $filter (eq, ne).

Beziehungen

Beziehung Typ Beschreibung
Basislinie configurationBaseline Eine Beziehung, die Details zu mindestens einer Ressource und einer Eigenschaft enthält, die der zu überwachenden Ressource zugeordnet ist. Wird nur mit $select zurückgegeben. Unterstützt $expand.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.configurationMonitor",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "inactivationReason": "String",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "mode": "String",
  "monitorRunFrequencyInHours": "Int32",
  "parameters": {"@odata.type": "microsoft.graph.openComplexDictionaryType"},
  "status": "String",
  "tenantId": "String"
}
  • Last updated on