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"
}