auditLogQuery-Ressourcentyp

Namespace: microsoft.graph.security

Stellt eine Abfrage für das Microsoft 365 Unified Audit-Protokoll dar. Verwenden Sie diese Ressource, um Suchparameter zu definieren und Überwachungsprotokolldatensätze abzurufen.

Erbt von microsoft.graph.entity.

Methoden

Methode	Rückgabetyp	Beschreibung
Abfrage des Überwachungsprotokolls abrufen	auditLogQuery	Lesen der Eigenschaften und Beziehungen eines auditLogQuery-Objekts .
Datensätze auflisten	auditLogRecord-Sammlung	Rufen Sie die auditLogRecord-Ressourcen aus der Navigationseigenschaft "Aufzeichnungen" ab.

Eigenschaften

Eigenschaft	Typ	Beschreibung
administrativeUnitIdFilters	String collection	Die Sammlung der Verwaltungseinheiten-IDs, nach denen gefiltert werden soll.
approximateReturnedRecordCount	Int64	Die ungefähre Anzahl der von der Abfrage abgerufenen Datensätze. Dieser Wert kann aufgrund der verteilten Zählung höher oder niedriger als recordCountLimit sein. Schreibgeschützt.
displayName	Zeichenfolge	Der Anzeigename der Überwachungsprotokollabfrage.
filterEndDateTime	DateTimeOffset	Das Enddatum und die Endzeit des Abfragefilters für das Überwachungsprotokoll.
filterStartDateTime	DateTimeOffset	Startdatum und -uhrzeit des Abfragefilters für das Überwachungsprotokoll.
id	Zeichenfolge	Der eindeutige Bezeichner für die Überwachungsprotokollabfrage. Geerbt von entity.
ipAddressFilters	String collection	Die Sammlung der IP-Adressen, nach denen gefiltert werden soll.
isRecordCountLimitExceeded	Boolean	Gibt an, ob die Abfrage den Grenzwert für die Anzahl der Datensätze pro Suche überschritten hat. Der Standardwert ist false. Der Wert ist true autoritativ und wird nicht von approximateReturnedRecordCount abgeleitet. Schreibgeschützt.
keywordFilter	Zeichenfolge	Freier Text, der mit dem nicht indizierten Inhalt jedes Datensatzes abgeglichen werden soll: die workloadspezifischen Eigenschaften in auditData, einschließlich des Objekts AppAccessContext . Die indizierten Eigenschaften des allgemeinen Schemas, wie z. B. der Vorgangsname, werden nicht mit einem Schlüsselwort (keyword) abgeglichen. Verwende für diese eigene Filter, z. B. operationFilters.
objectIdFilters	String collection	Die Sammlung der Objekt-IDs, nach denen gefiltert werden soll.
operationFilters	String collection	Die Auflistung der Vorgänge, nach denen gefiltert werden soll.
recordCountLimit	Int64	Der Schwellenwert für die Datensatzanzahl, der zum Einschränken des Abrufs von Abfrageergebnissen verwendet wird. Schreibgeschützt.
recordTypeFilters	microsoft.graph.security.auditLogRecordType collection	Die Sammlung der Datensatztypen, nach denen gefiltert werden soll.
serviceFilters	String collection	Die Sammlung der Dienste, nach denen gefiltert werden soll.
status	microsoft.graph.security.auditLogQueryStatus	Der Status der Überwachungsprotokollabfrage. Mögliche Werte sind: notStarted, running, succeeded, failed, cancelled und unknownFutureValue.
userPrincipalNameFilters	String collection	Die Auflistung der Benutzerprinzipalnamen, nach denen gefiltert werden soll.

Hinweis

Eine Überwachungsprotokollabfrage kann erfolgreich abgeschlossen werden, nachdem der Datensatzgrenzwert überschritten wurde. Verwenden Sie isRecordCountLimitExceeded, um festzustellen, ob der Grenzwert überschritten wurde. Informationen zu Mandanten- und Abfragezuordnungen finden Sie unter Dienstspezifische Drosselungsgrenzwerte für Microsoft Graph.

Beziehungen

Beziehung	Typ	Beschreibung
Rekorde speichern	microsoft.graph.security.auditLogRecord collection	Die Sammlung der Überwachungsprotokolldatensätze, die von der Abfrage abgerufen wurden.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.security.auditLogQuery",
  "id": "String (identifier)",
  "displayName": "String",
  "filterStartDateTime": "String (timestamp)",
  "filterEndDateTime": "String (timestamp)",
  "recordTypeFilters": ["String"],
  "keywordFilter": "String",
  "serviceFilters": ["String"],
  "operationFilters": ["String"],
  "userPrincipalNameFilters": ["String"],
  "ipAddressFilters": ["String"],
  "objectIdFilters": ["String"],
  "administrativeUnitIdFilters": ["String"],
  "status": "String",
  "approximateReturnedRecordCount": "Int64",
  "isRecordCountLimitExceeded": "Boolean",
  "recordCountLimit": "Int64"
}