Compartilhar via


userCredentialUsageDetails resource type (tipo de recurso userCredentialUsageDetails)

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.

Importante

A API de detalhes de utilização de credenciais do utilizador foi preterida e deixará de devolver dados a 1 de agosto de 2025. Em alternativa, utilize a nova API de Resumo de Eventos de Utilizador .

Representa a utilização da reposição personalizada de palavra-passe para um determinado inquilino. Os detalhes incluem informações do utilizador, status da reposição e o motivo da falha. Para obter mais informações sobre os requisitos de licença para esta funcionalidade, veja Authentication Methods Activity: Permissions and licenses (Atividade de Métodos de Autenticação: Permissões e licenças).

Métodos

Método Tipo de retorno Descrição
List userCredentialUsageDetails Ler propriedades e relações de um objeto userCredentialUsageDetails.

Propriedades

Propriedade Tipo Descrição
authMethod usageAuthMethod Representa o método de autenticação que o utilizador utilizou. 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 O tipo Timestamp 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 Fornece o motivo da falha para o fluxo de trabalho de reposição ou registo correspondente.
funcionalidade featureType Os valores possíveis são: registration, reset, unknownFutureValue.
id String Somente leitura. O identificador exclusivo da atividade. Somente leitura.
isSuccess Booliano Indica êxito ou falha do fluxo de trabalho.
userDisplayName Cadeia de caracteres Nome de utilizador do utilizador que executa o fluxo de trabalho de reposição ou registo.
userPrincipalName Cadeia de caracteres Nome principal de utilizador do utilizador que executa o fluxo de trabalho de reposição ou registo.

Relações

Nenhum

Representação JSON

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

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