userEventsSummary-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.

Stellt ein bestimmtes MFA/SSPR-Registrierungs- oder Zurücksetzungsereignis für Benutzer dar, einschließlich ob das Ereignis erfolgreich war, welche Authentifizierungsmethode beworben wurde und falls vorhanden.

Erbt von entity.

Methoden

Methode Rückgabetyp Beschreibung
List userEventsSummary-Sammlung Rufen Sie eine Liste der Benutzerregistrierungs- und Zurücksetzungsereignisse ab, wie im userEventsSummary-Objekt definiert.

Eigenschaften

Eigenschaft Typ Beschreibung
authMethod usageAuthMethod Die Authentifizierungsmethode, auf die das Ereignis abzielt.
eventDateTime DateTimeOffset Datum und Uhrzeit (UTC), als das Ereignis aufgetreten ist. Der DateTimeOffset-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
failureReason Zeichenfolge Der genaue Grund, warum das Ereignis fehlgeschlagen ist (wenn es nicht erfolgreich war).
Feature featureType Der Typ des aufgetretenen Ereignisses. Die möglichen Werte sind: registration, reset, unknownFutureValue.
id Zeichenfolge Benutzerobjektbezeichner in Microsoft Entra ID. Geerbt von entity.
isSuccess Boolean Gibt an, ob das Ereignis erfolgreich war oder nicht.
userDisplayName String Der Anzeigename des Benutzers, z. B Adele Vance. Unterstützt $filter (eq,) startsWithund $orderby.
userPrincipalName Zeichenfolge Der Benutzerprinzipalname, z. B AdeleV@contoso.com. Unterstützt $filter (eq,) startsWithund $orderby.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.userEventsSummary",
  "id": "String (identifier)",
  "feature": "String",
  "userPrincipalName": "String",
  "userDisplayName": "String",
  "isSuccess": "Boolean",
  "authMethod": "String",
  "failureReason": "String",
  "eventDateTime": "String (timestamp)"
}