signInActivity 资源类型

命名空间：microsoft.graph

重要

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

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

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

属性

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

JSON 表示形式

下面是资源的 JSON 表示形式。

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