tipo de recurso auditLogQuery

Namespace: microsoft.graph.security

Representa uma consulta no log de auditoria unificada do Microsoft 365. Use este recurso para definir parâmetros de pesquisa e recuperar registros de log de auditoria.

Herda de microsoft.graph.entity.

Métodos

Método Tipo de retorno Descrição
Obter consulta de log de auditoria auditLogQuery Leia as propriedades e relações de um objeto auditLogQuery .
Listar registros Coleta auditLogRecord Obtenha os recursos auditLogRecord da propriedade de navegação de registros.

Propriedades

Propriedade Tipo Descrição
administrativeUnitIdFilters String collection A coleção de IDs de unidades administrativas para filtrar.
approximateReturnedRecordCount Int64 O número aproximado de registros recuperados pela consulta. Esse valor pode ser maior ou menor que recordCountLimit devido à contagem distribuída. Somente leitura.
displayName Cadeia de caracteres O nome de exibição da consulta de log de auditoria.
filterEndDateTime DateTimeOffset A data e a hora de término do filtro de consulta de log de auditoria.
filterStartDateTime DateTimeOffset A data e a hora de início do filtro de consulta do log de auditoria.
id Cadeia de caracteres O identificador exclusivo para a consulta de log de auditoria. Herdado da entidade.
ipAddressFilters String collection A coleção de endereços IP para filtrar.
isRecordCountLimitExceeded Booliano Indica se a consulta excedeu o limite de contagem de registros por pesquisa. O valor padrão é false. Um valor de true é autoritativo e não é derivado de approximateReturnedRecordCount. Somente leitura.
palavra-chave Filter Cadeia de caracteres Texto livre para corresponder ao conteúdo não indexado de cada registro: as propriedades específicas da carga de trabalho dentro de auditData, incluindo seu AppAccessContext objeto. As propriedades de esquema comum indexadas, como o nome da operação, não são correspondidas por palavra-chave; use seus próprios filtros, como operationFilters, para elas.
objectIdFilters String collection A coleção de IDs de objeto a serem filtradas.
operationFilters String collection A coleção de operações a serem filtradas.
recordCountLimit Int64 O limite de contagem de registros usado para limitar a recuperação de resultados de consulta. Somente leitura.
recordTypeFilters Coleção microsoft.graph.security.auditLogRecordType A coleção de tipos de registro para filtrar.
serviceFilters String collection A coleção de serviços a serem filtrados.
status microsoft.graph.security.auditLogQueryStatus O status da consulta de log de auditoria. Os possíveis valores são: notStarted, running, succeeded, failed, cancelled, unknownFutureValue.
userPrincipalNameFilters String collection A coleção de nomes principais de usuário para filtrar.

Observação

Uma consulta de log de auditoria pode ser concluída com êxito depois de exceder seu limite de contagem de registros. Use isRecordCountLimitExceeded para determinar se o limite foi excedido. Para obter informações sobre alocações de locatário e por consulta, consulte Limites de limitação específicos do serviço do Microsoft Graph.

Relações

Relação Tipo Descrição
registros Coleção microsoft.graph.security.auditLogRecord A coleção de registros de log de auditoria recuperados pela consulta.

Representação JSON

A representação JSON a seguir mostra o 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"
}