Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Namespace: microsoft.graph
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Represents a specific user MFA/SSPR registration or reset event, including whether the event was successful, which authentication method was targeted, and failure reason if any.
Inherits from entity.
Methods
| Method | Return type | Description |
|---|---|---|
| List | userEventsSummary collection | Get a list of the user registration and reset events as defined in the userEventsSummary object. |
Properties
| Property | Type | Description |
|---|---|---|
| authMethod | usageAuthMethod | The authentication method being targeted in the event. The possible values are: email, mobileSMS, mobileCall, officePhone, securityQuestion, appNotification, appCode, alternateMobileCall, fido, appPassword, unknownFutureValue, externalAuthMethod.. Use the Prefer: include-unknown-enum-members request header to get the following values from this evolvable enum: externalAuthMethod. |
| eventDateTime | DateTimeOffset | The date and time (UTC) when the event occurred. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. |
| failureReason | String | The specific reason why the event failed (if it was not successful.) |
| feature | featureType | The type of event that occurred. The possible values are: registration, reset, unknownFutureValue. |
| id | String | User object identifier in Microsoft Entra ID. Inherited from entity. |
| isSuccess | Boolean | Indicates whether the event was successful or not. |
| userDisplayName | String | The user display name, such as Adele Vance. Supports $filter (eq, startsWith) and $orderby. |
| userPrincipalName | String | The user principal name, such as AdeleV@contoso.com. Supports $filter (eq, startsWith) and $orderby. |
Relationships
None.
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.userEventsSummary",
"id": "String (identifier)",
"feature": "String",
"userPrincipalName": "String",
"userDisplayName": "String",
"isSuccess": "Boolean",
"authMethod": "String",
"failureReason": "String",
"eventDateTime": "String (timestamp)"
}