auditLogQuery 资源类型

命名空间: microsoft.graph.security

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

表示用于查询和检索相关审核日志记录的审核日志查询。

继承自 microsoft.graph.entity。

方法

方法 返回类型 说明
列出 auditLogQueries auditLogQuery 集合 获取 auditLogQuery 对象及其属性的列表。
创建 auditLogQuery auditLogQuery 创建新的 auditLogQuery 对象。
获取 auditLogQuery auditLogQuery 读取 auditLogQuery 对象的属性和关系。
列出记录 auditLogRecord 集合 从记录导航属性获取 auditLogRecord 资源。

属性

属性 类型 说明
administrativeUnitIdFilters 字符串集合 标记到审核日志记录的管理单元。
approximateReturnedRecordCount Int64 查询检索的大致记录数。 由于分布式计数,此值可能高于或低于 recordCountLimit 。 只读。
displayName String 保存的审核日志查询的显示名称。
filterEndDateTime DateTimeOffset 查询中日期范围的结束日期。
filterStartDateTime DateTimeOffset 查询中日期范围的开始日期。
id String 审核日志查询的唯一标识符。 继承自 microsoft.graph.entity。
ipAddressFilters 字符串集合 记录活动时使用的设备的 IP 地址。
isRecordCountLimitExceeded 布尔值 指示查询是否超出了每个搜索记录计数的限制。 默认值为 false。 值 true 具有权威性,并非派生自 approximateReturnedRecordCount。 只读。
keywordFilter String 用于与每条记录的未索引内容匹配的自由文本: auditData 中的工作负荷特定属性,包括其 AppAccessContext 对象。 索引的通用架构属性(如操作名称)与 关键字 (keyword) 不匹配;对它们使用它们自己的筛选器,如 operationFilters。
objectIdFilters 字符串集合 对于 SharePoint 和 OneDrive for Business 活动,用户访问的文件或文件夹的完整路径名称。 对于 Exchange 管理员审核日志,通过 cmdlet 修改的对象的名称。
operationFilters 字符串集合 用户或管理员活动的名称。 有关最常见操作/活动的说明,请参阅在 Office 365 保护中心搜索审核日志。
recordCountLimit Int64 用于限制查询结果检索的记录计数阈值。 只读。
recordTypeFilters microsoft.graph.security.auditLogRecordType 集合 记录指示的操作类型。 有关成员值的列表,请参阅 auditLogRecordType。
serviceFilter String 指审核记录中的工作负荷属性。 这是发生此活动的 Microsoft 服务。 可选。
status microsoft.graph.security.auditLogQueryStatus 描述查询的当前状态。 可能的值包括 notStarted、running、succeeded、failed、cancelled、unknownFutureValue。
userPrincipalNameFilters 字符串集合 执行操作属性 (中指定的操作) 并导致记录记录的用户的 UPN (用户主体名称) ;例如, my_name@my_domain_name。

注意

超过其记录计数限制后,审核日志查询可以成功完成。 使用 isRecordCountLimitExceeded 确定是否超出了限制。 有关租户和每个查询分配的信息,请参阅 Microsoft Graph 服务特定的限制。

关系

关系 类型 说明
记录 microsoft.graph.security.auditLogRecord 集合 单个审核日志记录。

JSON 表示形式

以下 JSON 表示形式显示资源类型。

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