Obter riskyUserGet riskyUser

Namespace: microsoft.graphNamespace: microsoft.graph

Importante

As APIs na /beta versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported.

Recupere as propriedades e os relacionamentos de um objeto riskyUser .Retrieve the properties and relationships of a riskyUser object.

Observação: O uso da API riskyUsers requer uma licença do Azure AD Premium P2.Note: Using the riskyUsers API requires an Azure AD Premium P2 license.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) IdentityRiskyUser.Read.AllIdentityRiskyUser.Read.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication IdentityRiskyUser.Read.AllIdentityRiskyUser.Read.All

Solicitação HTTPHTTP request

GET /riskyUsers/{id}
GET /identityProtection/riskyUsers/{id}

Cabeçalhos de solicitaçãoRequest headers

NomeName DescriçãoDescription
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Workbook-Session-IdWorkbook-Session-Id ID da sessão da pasta de trabalho que determina se as alterações são persistentes.Workbook session ID that determines whether changes are persisted. Opcional.Optional.

Corpo da solicitaçãoRequest body

Não forneça um corpo de solicitação para esse método.Do not supply a request body for this method.

RespostaResponse

Se tiver êxito, este método retornará um 200 OK código de resposta e um objeto riskyUser no corpo da resposta.If successful, this method returns a 200 OK response code and a riskyUser object in the response body.

ExemplosExamples

Exemplo 1: obter um usuário arriscadoExample 1: Get a risky user

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

GET https://graph.microsoft.com/beta/riskyUsers/c2b6c2b9-dddc-acd0-2b39-d519d803dbc3

RespostaResponse

Veja a seguir um exemplo da resposta.Here is an example of the response.

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

{
  "id": "c2b6c2b9-dddc-acd0-2b39-d519d803dbc3",
  "riskLastUpdatedDateTime": "2016-01-29T20:03:57.7872426Z",
  "isProcessing": true,
  "isDeleted": true,
  "riskDetail": "adminConfirmedSigninCompromised",
  "riskLevel": "high",
  "riskState": "atRisk",
  "userDisplayName": "Alex Wilbur",
  "userPrincipalName": "alexw@contoso.com"
}

Exemplo 2: obter usuários arriscadosExample 2: Get risky users

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

GET https://graph.microsoft.com/beta/identityProtection/riskyUsers

RespostaResponse

Veja a seguir um exemplo da resposta.Here is an example of the response.

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

{
  "id": "c2b6c2b9-dddc-acd0-2b39-d519d803dbc3",
  "riskLastUpdatedDateTime": "2016-01-29T20:03:57.7872426Z",
  "isGuest": true,
  "isProcessing": true,
  "isDeleted": true,
  "riskDetail": "adminConfirmedSigninCompromised",
  "riskLevel": "high",
  "riskState": "atRisk",
  "userDisplayName": "Alex Wilbur",
  "userPrincipalName": "alexw@contoso.com"
}