命名空间: microsoft.graph.security
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
表示用于查询和检索相关审核日志记录的审核日志查询。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 列出 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"
}