Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
- A utilização da API riskyUsers requer uma licença P2 Microsoft Entra ID.
- 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"
}