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"
}
  • Zuletzt aktualisiert um