signInActivity 资源类型

命名空间:microsoft.graph

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

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

属性

属性 类型 说明
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 特定用户的最后一个交互式登录日期和时间。 可以使用此字段计算用户上次尝试 (成功或失败的时间,) 使用交互式身份验证方法登录到目录。 此字段可用于生成报表,例如非活动用户。 时间戳类型使用 ISO 8601 格式表示日期和时间信息,并且始终采用 UTC 格式。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 Microsoft Entra ID会保留可追溯到 2020 年 4 月的交互式登录。 有关使用此属性的值的详细信息,请参阅管理 Microsoft Entra ID 中的非活动用户帐户
lastSignInRequestId String 此用户执行的最后一次交互式登录的请求标识符。
lastSuccessfulSignInDateTime DateTimeOffset 用户最近成功登录活动的日期和时间。 时间戳类型使用 ISO 8601 格式表示日期和时间信息,并且始终采用 UTC 格式。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
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"
}