Compartilhar via


tipo de recurso riskyUser

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 Microsoft Entra utilizadores em risco. Microsoft Entra ID Protection avalia continuamente o risco do utilizador com base em vários sinais e machine learning. Esta API fornece acesso programático a todos os utilizadores em risco no seu inquilino Microsoft Entra.

Para obter mais informações sobre eventos de risco, veja Microsoft Entra ID Protection.

Observação

  1. A utilização da API riskyUsers requer uma licença P2 Microsoft Entra ID.
  2. A disponibilidade de dados de utilizadores de risco é regida pelas políticas de retenção de dados Microsoft Entra.

Métodos

Método Tipo de retorno Descrição
List riskyUser collection Obtenha uma lista dos objetos riskyUser e respetivas propriedades.
Get riskyUser Leia as propriedades e relações de um objeto riskyUser .
Confirmar comprometimento Nenhum Confirme um ou mais objetos riskyUser como comprometidos.
Confirmar segurança Nenhum Confirme um ou mais objetos riskyUser como seguros.
Dismiss Nenhum Dispensar o risco de um ou mais objetos riskyUser .
Histórico de listas riskyUserHistoryItem collection Obtenha os riskyUserHistoryItems da propriedade de navegação do histórico.

Propriedades

Propriedade Tipo Descrição
id string ID exclusivo do utilizador em risco.
isDeleted Booliano Indica se o utilizador foi eliminado. Os valores possíveis são: true, false.
isProcessing Booliano Indica se o estado de risco de um utilizador está a ser processado pelo back-end.
riskLastUpdatedDateTime DateTimeOffset A data e hora em que o utilizador de risco foi atualizado pela última vez. 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.
riskLevel riskLevel Nível do utilizador de risco detetado. Os valores possíveis são low, medium, high, hidden, none, . unknownFutureValue
riskState riskState Estado do risco do utilizador. Os valores possíveis são none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised, unknownFutureValue.
riskDetail riskDetail Detalhes do risco detetado.
Nota: Os detalhes desta propriedade só estão disponíveis para clientes Microsoft Entra ID P2. Todos os outros clientes são devolvidos hidden.
userDisplayName string Nome a apresentar do utilizador de risco.
userPrincipalName string Nome principal de utilizador de risco.

Relações

Nenhum

Representação JSON

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

{
"id": "string",
"riskLastUpdatedDateTime": "dateTimeOffset",
"isProcessing": "Boolean",
"isDeleted": "Boolean",
"riskDetail":  "string",
"riskLevel":  "string",
"riskState":  "string",
"userDisplayName": "string",
"userPrincipalName": "string"
}