tipo de recurso auditLogQuery

Namespace: microsoft.graph.security

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Representa uma consulta de log de auditoria usada para consultar e recuperar registros de log de auditoria relevantes.

Herda de microsoft.graph.entity.

Métodos

Método Tipo de retorno Descrição
Listar auditLogQueries Coleção auditLogQuery Obtenha uma lista dos objetos auditLogQuery e suas propriedades.
Criar auditLogQuery auditLogQuery Crie um novo objeto auditLogQuery .
Obter auditLogQuery 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 As unidades administrativas marcadas para um registro de log de auditoria.
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 salva.
filterEndDateTime DateTimeOffset A data de término do intervalo de datas na consulta.
filterStartDateTime DateTimeOffset A data de início do intervalo de datas na consulta.
id Cadeia de caracteres Identificador exclusivo para a consulta de log de auditoria. Herdado de microsoft.graph.entity.
ipAddressFilters String collection O endereço IP do dispositivo que foi usado quando a atividade foi registrada.
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 Para atividades do SharePoint e do OneDrive for Business, o nome do caminho completo do arquivo ou pasta acessado pelo usuário. Para o log de auditoria do administrador do Exchange, o nome do objeto que foi modificado pelo cmdlet.
operationFilters String collection O nome do usuário ou atividade administrativa. Para obter uma descrição das operações/atividades mais comuns, veja Pesquisar o log de auditoria no Centro de Proteção do Office 365.
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 O tipo de operação indicado pelo registro. Para obter a lista de valores de membro, consulte auditLogRecordType.
serviceFilter Cadeia de caracteres Refere-se à propriedade de carga de trabalho no registro de auditoria. Este é o serviço da Microsoft em que a atividade ocorreu. Opcional.
status microsoft.graph.security.auditLogQueryStatus Descreve o status atual da consulta. Os valores possíveis são: notStarted, running, succeeded, failed, cancelled, unknownFutureValue.
userPrincipalNameFilters String collection O UPN (nome UPN) do usuário que executou a ação (especificada na propriedade operation) que resultou no registro do registro; Por exemplo, my_name@my_domain_name.

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 Um registro de log de auditoria individual.

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",
  "serviceFilter": "String",
  "operationFilters": [
    "String"
  ],
  "userPrincipalNameFilters": [
    "String"
  ],
  "ipAddressFilters": [
    "String"
  ],
  "objectIdFilters": [
    "String"
  ],
  "administrativeUnitIdFilters": [
    "String"
  ],
  "status": "String",
  "isRecordCountLimitExceeded": "Boolean",
  "recordCountLimit": "Int64",
  "approximateReturnedRecordCount": "Int64"
}
  • Última atualização em