directoryAudit 资源类型

命名空间：microsoft.graph

重要

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

表示目录审核项及其集合。

方法

方法	返回类型	说明
列出 directoryAudits	directoryAudit	列出集合中的目录审核项及其属性。
获取 directoryAudit	directoryAudit	获取特定目录审核项及其属性。

属性

属性	类型	说明
activityDateTime	DateTimeOffset	指示执行活动的日期和时间。 时间戳类型始终为 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 支持 $filter (eq、、 gele) 和 $orderby。
activityDisplayName	String	指示活动名称或操作名称 (例如“创建用户”、“将成员添加到组”) 。 有关记录的活动列表，请参阅Microsoft Entra审核日志类别和活动。 支持 $filter（eq、startswith）。
additionalDetails	keyValue 集合	指示有关活动的更多详细信息。
“类别”	String	指示活动所针对的资源类别。 例如： UserManagement、 GroupManagement、 ApplicationManagement、 RoleManagement。 有关记录的活动的类别列表，请参阅Microsoft Entra审核日志类别和活动。
correlationId	Guid	指示有助于关联跨各种服务的活动的唯一 ID。 可用于跨服务跟踪日志。 支持 $filter（eq）。
id	String	指示活动的唯一 ID。 支持 $filter（eq）。
initiatedBy	auditActivityInitiator	指示有关启动活动的用户或应用的信息。 支持 $filter (/eq 用户ID、用户/displayName、userPrincipalName/、appId/、app/ displayName 和 $filteruserPrincipalName (startswith) ) 。/
loggedByService	String	指示启动活动的服务的信息（例如：自助服务密码管理、核心目录、B2C、受邀用户、Microsoft Identity Manager、Privileged Identity Management）。 支持 $filter（eq）。
operationType	String	指示执行的操作类型。 可能的值包括但不限于以下值：Add、、Assign、UpdateUnassign、 和 Delete。
result	operationResult	指示活动的结果。 可能的值是：success、failure、timeout、unknownFutureValue。
resultReason	String	指示失败的原因（如果 结果 为 failure 或 timeout）。
targetResources	targetResource 集合	有关因活动而更改的资源的信息。 支持 $filterid 和displayName 的 (eq) ;$filter对 displayName 支持 (startswith) 。
userAgent	String	用户在活动中使用的用户代理的类型。

关系

无

JSON 表示形式

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

{
  "activityDateTime": "String (timestamp)",
  "activityDisplayName": "String",
  "additionalDetails": [{"@odata.type": "microsoft.graph.keyValue"}],
  "category": "String",
  "correlationId": "Guid",
  "id": "String (identifier)",
  "initiatedBy": {"@odata.type": "microsoft.graph.auditActivityInitiator"},
  "loggedByService": "String",
  "operationType": "String",
  "result": "string",
  "resultReason": "String",
  "targetResources": [{"@odata.type": "microsoft.graph.targetResource"}],
  "userAgent": "String"
}