userCredentialUsageDetails resource type

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 the self-service password reset usage for a given tenant. Details include user information, status of the reset, and the reason for failure. For more information about license requirements for this feature, see Authentication Methods Activity: Permissions and licenses.

Methods

Method	Return Type	Description
List userCredentialUsageDetails	userCredentialUsageDetails	Read properties and relationships of a userCredentialUsageDetails object.

Properties

Property	Type	Description
authMethod	usageAuthMethod	Represents the authentication method that the user used. Possible values are:email, mobileSMS, mobileCall, officePhone, securityQuestion (only used for self-service password reset), appNotification, appCode, alternateMobileCall (supported only in registration), fido, appPassword,unknownFutureValue
eventDateTime	DateTimeOffset	The Timestamp 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	Provides the failure reason for the corresponding reset or registration workflow.
feature	featureType	Possible values are: registration, reset, unknownFutureValue.
id	String	Read-only. The unique identifier for the activity. Read-only.
isSuccess	Boolean	Indicates success or failure of the workflow.
userDisplayName	String	User name of the user performing the reset or registration workflow.
userPrincipalName	String	User principal name of the user performing the reset or registration workflow.

Relationships

None.

JSON representation

The following is a JSON representation of the resource.

{
  "id" : "String",
  "feature":"string",
  "userPrincipalName":"String",
  "userDisplayName": "String",
  "isSuccess" : true,
  "authMethod": "string",
  "failureReason": "String",
  "eventDateTime" : "DateTimeOffset"
}