Compartilhar via


userEventsSummary resource type

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Representa um evento de reposição ou registo MFA/SSPR de utilizador específico, incluindo se o evento foi bem-sucedido, qual o método de autenticação visado e o motivo da falha, se existir.

Herda de entidade.

Methods

Método Tipo de retorno Descrição
List coleção userEventsSummary Obtenha uma lista dos eventos de registo e reposição do utilizador, conforme definido no objeto userEventsSummary .

Propriedades

Propriedade Tipo Descrição
authMethod usageAuthMethod O método de autenticação que está a ser visado no evento. Os valores possíveis são: email, , mobileSMS, mobileCallofficePhone, securityQuestion, appCodeappNotification, , alternateMobileCall, fido, appPassword, externalAuthMethodwindowsHelloForBusinessmicrosoftAuthenticatorPasswordlesshardwareOneTimePasscodemacOsSecureEnclaveKeyunknownFutureValuetemporaryAccessPass, passKeyDeviceBound, , passKeyDeviceBoundAuthenticator, passKeyDeviceBoundWindowsHello, , softwareOneTimePasscode, microsoftAuthenticatorPush, . mobilePhonesmsalternateMobilePhonefido2SecurityKeyoneTimePasscodepassKeySynced Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: externalAuthMethod , , windowsHelloForBusinesshardwareOneTimePasscode , microsoftAuthenticatorPasswordless , temporaryAccessPass , macOsSecureEnclaveKey , passKeyDeviceBound , passKeyDeviceBoundAuthenticator , , passKeyDeviceBoundWindowsHello , softwareOneTimePasscode , microsoftAuthenticatorPush , mobilePhone , , sms , , alternateMobilePhone , , fido2SecurityKey , , oneTimePasscode . passKeySynced
eventDateTime DateTimeOffset A data e hora (UTC) em que o evento ocorreu. O tipo DateTimeOffset representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.
failureReason Cadeia de caracteres O motivo específico pelo qual o evento falhou (se não tiver sido bem-sucedido).)
funcionalidade featureType O tipo de evento que ocorreu. Os valores possíveis são: registration, reset, unknownFutureValue.
id Cadeia de caracteres Identificador de objeto de utilizador no Microsoft Entra ID. Herdado da entidade.
isSuccess Booliano Indica se o evento foi ou não bem-sucedido.
userDisplayName Cadeia de caracteres O nome a apresentar do utilizador, como Adele Vance. $filter Suporta (eq, startsWith) e $orderby.
userPrincipalName Cadeia de caracteres O nome principal de utilizador, como AdeleV@contoso.com. $filter Suporta (eq, startsWith) e $orderby.

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

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