userCredentialUsageDetails Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Wichtig

Die API für die Nutzungsdetails von Benutzeranmeldeinformationen ist veraltet und gibt ab dem 1. August 2025 keine Daten mehr zurück. Verwenden Sie stattdessen die neue API zur Zusammenfassung von Benutzerereignissen .

Stellt die Nutzung der Self-Service-Kennwortzurücksetzung für einen bestimmten Mandanten dar. Zu den Details gehören Benutzerinformationen, der Status des Zurücksetzens und der Grund für das Fehlschlagen. Weitere Informationen zu den Lizenzanforderungen für dieses Feature finden Sie unter Aktivität für Authentifizierungsmethoden: Berechtigungen und Lizenzen.

Methoden

Methode Rückgabetyp Beschreibung
List userCredentialUsageDetails Lesen von Eigenschaften und Beziehungen eines userCredentialUsageDetails-Objekts.

Eigenschaften

Eigenschaft Typ Beschreibung
authMethod usageAuthMethod Stellt die Authentifizierungsmethode dar, die der Benutzer verwendet hat.
eventDateTime DateTimeOffset Der Typ „Zeitstempel“ stellt die Datums- und Uhrzeitinformationen im Format der ISO 8601 dar und gibt immer die UTC an. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
failureReason Zeichenfolge Stellt den Fehlergrund für den entsprechenden Zurücksetzungs- oder Registrierungsworkflow bereit.
Feature featureType Die möglichen Werte sind: registration, reset, unknownFutureValue.
id Zeichenfolge Schreibgeschützt. Der eindeutige Bezeichner für die Aktivität. Schreibgeschützt.
isSuccess Boolean Zeigt den Erfolg oder Misserfolg des Workflows an.
userDisplayName String Benutzername des Benutzers, der den Zurücksetzungs- oder Registrierungsworkflow durchführt.
userPrincipalName Zeichenfolge Benutzerprinzipalname des Benutzers, der den Zurücksetzungs- oder Registrierungsworkflow durchführt.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

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