Listar credentialUserRegistrationDetails

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 de versão.

Obter uma lista de objetos credentialUserRegistrationDetails para um determinado locatário.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegada (conta corporativa ou de estudante) Reports.Read.All
Delegada (conta pessoal da Microsoft) Sem suporte.
Aplicativo Reports.Read.All

Solicitação HTTP

GET /reports/credentialUserRegistrationDetails

Parâmetros de consulta opcionais

Esta função dá suporte ao parâmetro opcional de consulta OData $filter. Você pode aplicar $filter em uma ou mais das seguintes propriedades do recurso credentialUserRegistrationDetails.

Propriedades Descrição e exemplo
userDisplayName Filtrar por nome de usuário. Por exemplo: /reports/credentialUserRegistrationDetails?$filter=userDisplayName eq 'Contoso'. Operadores de filtro com suporte: eq e startswith() . Oferece suporte a maiúsculas e minúsculas.
userPrincipalName Filtrar pelo nome principal do usuário. Por exemplo: /reports/credentialUserRegistrationDetails?$filter=userPrincipalName eq 'Contoso'. Operadores de filtro com suporte: eq e startswith() . Oferece suporte a maiúsculas e minúsculas.
authMethods Filtrar pelos métodos de autenticação usados durante o registro. Por exemplo: /reports/credentialUserRegistrationDetails?$filter=authMethods/any(t:t eq microsoft.graph.registrationAuthMethod'email'). Operadores de filtro com suporte: eq .
isRegistered Filtrar para usuários que se registraram para redefinição de senha de autoatendados (SSPR). Por exemplo: /reports/credentialUserRegistrationDetails?$filter=isRegistered eq true. Operadores de filtro com suporte: eq .
isEnabled Filtrar para usuários que foram habilitados para SSPR. Por exemplo: /reports/credentialUserRegistrationDetails?$filter=isEnabled eq true. Operadores de filtter com suporte: eq .
isCapable Filtrar para usuários que estão prontos para executar a redefinição de senha ou a autenticação multifafatória (MFA). Por exemplo: /reports/credentialUserRegistrationDetails?$filter=isCapable eq true. Operadores de filtro com suporte: eq
isMfaRegistered Filtrar para usuários que estão registrados para MFA. Por exemplo: /reports/credentialUserRegistrationDetails?$filter=isMfaRegistered eq true. Operadores de filtro com suporte: eq .

Cabeçalhos de solicitação

Nome Descrição
Autorização Portador {token}
Content-Type application/json

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se tiver êxito, este método retornará um código de resposta e uma coleção de 200 OK objetos credentialUserRegistrationDetails no corpo da resposta.

Exemplos

O exemplo a seguir mostra como chamar essa API.

Solicitação

Este é um exemplo de solicitação.

GET https://graph.microsoft.com/beta/reports/credentialUserRegistrationDetails

Resposta

Este é um exemplo de resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade. Todas as propriedades são retornadas de uma chamada real.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context":"https://graph.microsoft.com/beta/reports/$metadata#Collection(microsoft.graph.credentialUserRegistrationDetails)",
  "value":[
    {
      "id" : "id-value",
      "userPrincipalName":"userPrincipalName",
      "userDisplayName": "userDisplayName-value",
      "authMethods": ["email", "mobileSMS"],
      "isRegistered" : false,
      "isEnabled" : true,
      "isCapable" : false,
      "isMfaRegistered" : true
    }
  ]
}