signInActivity 资源类型

命名空间:microsoft.graph

为特定用户提供最后一次交互式或非交互式登录尝试时间。 由于 signInActivity 描述用户对象的属性,因此,只要用户对象存在,Microsoft Entra ID就存储用户的登录活动。

自 2023 年 12 月 1 日起, lastSuccessfulSignInDateTime 属性可用于为特定用户提供上次 成功 登录的时间,而不管登录是交互式登录还是非交互式登录。 不会为此属性回填数据。

请参阅 获取 signInActivity 详细信息的示例。

属性

属性 类型 说明
lastNonInteractiveSignInDateTime DateTimeOffset 特定用户的最后一个非交互式登录日期。 可以使用此字段计算客户端上次尝试 (成功或失败的时间,) 代表用户登录到目录。 由于某些用户可能会使用客户端访问租户资源,而不是直接登录到租户,因此可以将非交互式登录日期与 lastSignInDateTime 一起使用来标识非活动用户。 时间戳类型使用 ISO 8601 格式表示日期和时间信息,并且始终采用 UTC 格式。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 Microsoft Entra ID会保留自 2020 年 5 月起的非交互式登录。 有关使用此属性的值的详细信息,请参阅管理 Microsoft Entra ID 中的非活动用户帐户
lastNonInteractiveSignInRequestId String 此用户执行的最后一次非交互式登录的请求标识符。
lastSignInDateTime DateTimeOffset 特定用户的最后一个交互式登录日期和时间。 此属性记录用户上次尝试以交互方式登录到目录的时间,无论尝试是否成功。 注意:由于还会记录失败的尝试,因此此值可能无法准确反映实际系统使用情况。 若要跟踪实际帐户访问权限,请使用 lastSuccessfulSignInDateTime 属性。 时间戳类型使用 ISO 8601 格式表示日期和时间信息,并且始终采用 UTC 格式。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
lastSignInRequestId String 此用户执行的最后一次交互式登录的请求标识符。
lastSuccessfulSignInDateTime DateTimeOffset 用户最近成功进行交互式或非交互式登录的日期和时间。 如果需要确定何时真正访问帐户,请使用此属性。 此字段可用于生成报表,例如非活动用户。 时间戳类型使用 ISO 8601 格式表示日期和时间信息,并且始终采用 UTC 格式。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 Microsoft Entra ID会保留可追溯到 2020 年 4 月的交互式登录。 有关使用此属性的值的详细信息,请参阅管理 Microsoft Entra ID 中的非活动用户帐户
lastSuccessfulSignInRequestId String 上次成功登录的请求 ID。

JSON 表示形式

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

{
  "@odata.type": "#microsoft.graph.signInActivity",
  "lastNonInteractiveSignInDateTime": "String (timestamp)",
  "lastNonInteractiveSignInRequestId": "String",
  "lastSignInDateTime": "String (timestamp)",
  "lastSignInRequestId": "String",
  "lastSuccessfulSignInDateTime": "String (timestamp)",
  "lastSuccessfulSignInRequestId": "String"
}