Edit

Share via

userCredentialUsageDetails resource type

  • Article

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 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 JSON representation shows the resource type.

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