Tipo de recurso auditLogQuery

Espacio de nombres: microsoft.graph.security

Representa una consulta en el registro de auditoría unificado de Microsoft 365. Usa este recurso para definir parámetros de búsqueda y recuperar registros de auditoría.

Hereda de microsoft.graph.entity.

Métodos

Método	Tipo devuelto	Description
Obtener consulta de registro de auditoría	auditLogQuery	Lee las propiedades y las relaciones de un objeto auditLogQuery .
Enumerar registros	Recopilación auditLogRecord	Obtenga los recursos auditLogRecord de la propiedad de navegación de registros.

Propiedades

Propiedad	Tipo	Description
administrativeUnitIdFilters	Colección string	Colección de identificadores de unidad administrativa que se van a filtrar.
approximateReturnedRecordCount	Int64	Número aproximado de registros recuperados por la consulta. Este valor puede ser mayor o menor que recordCountLimit debido al recuento distribuido. Solo lectura.
displayName	Cadena	El nombre para mostrar de la consulta de registro de auditoría.
filterEndDateTime	DateTimeOffset	Fecha y hora de finalización del filtro de consulta de registro de auditoría.
filterStartDateTime	DateTimeOffset	La fecha y hora de inicio del filtro de consulta de registro de auditoría.
id	Cadena	El identificador único de la consulta del registro de auditoría. Heredado de la entidad.
ipAddressFilters	Colección string	Colección de direcciones IP que se van a filtrar.
isRecordCountLimitExceeded	Booleano	Indica si la consulta superó el límite de recuento de registros por búsqueda. El valor predeterminado es false. Un valor de true es autoritativo y no se deriva de approximateReturnedRecordCount. Solo lectura.
keywordFilter	Cadena	Texto libre para comparar con el contenido no indexado de cada registro: las propiedades específicas de la carga de trabajo dentro de auditData, incluido su AppAccessContext objeto. Las propiedades de esquema común indexadas, como el nombre de la operación, no coinciden con las palabras clave; use sus propios filtros, como operationFilters, para ellos.
objectIdFilters	Colección string	La colección de identificadores de objeto que se van a filtrar.
operationFilters	Colección string	La colección de operaciones que se van a filtrar.
recordCountLimit	Int64	El umbral de recuento de registros usado para limitar la recuperación de resultados de consultas. Solo lectura.
recordTypeFilters	Colección microsoft.graph.security.auditLogRecordType	Colección de tipos de registro que se van a filtrar.
serviceFilters	Colección string	La colección de servicios que se van a filtrar.
status	microsoft.graph.security.auditLogQueryStatus	El estado de la consulta del registro de auditoría. Los valores posibles son: notStarted, running, succeeded, failed, cancelled, unknownFutureValue.
userPrincipalNameFilters	Colección string	La colección de nombres principales de usuario que se van a filtrar.

Nota:

Una consulta de registro de auditoría se puede completar correctamente después de superar su límite de recuento de registros. Use isRecordCountLimitExceeded para determinar si se superó el límite. Para obtener información sobre las asignaciones de inquilinos y por consulta, consulte Límites de limitación específicos del servicio Microsoft Graph.

Relaciones

Relación	Tipo	Description
records	Recopilación microsoft.graph.security.auditLogRecord	La colección de registros de auditoría recuperados por la consulta.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

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