Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Representa Microsoft Entra usuarios que están en riesgo. Microsoft Entra ID evalúa continuamente el riesgo del usuario en función de varias señales y aprendizaje automático. Esta API proporciona acceso mediante programación a todos los usuarios en riesgo de la Microsoft Entra ID.
Para obtener más información sobre los eventos de riesgo, consulte protección contra Microsoft Entra ID.
Nota:
- El uso de la API riskyUsers requiere una licencia Microsoft Entra ID P2.
- La disponibilidad de datos de usuario de riesgo se rige por las directivas de retención de datos Microsoft Entra.
Métodos
| Método | Tipo devuelto | Descripción |
|---|---|---|
| List | colección riskyUser | Obtenga una lista de los objetos riskyUser y sus propiedades. |
| Get | riskyUser | Lea las propiedades y relaciones de un objeto riskyUser . |
| Confirmar lo que está en peligro | Ninguno | Confirme que uno o más objetos RiskyUser están en peligro. |
| Confirmación de la seguridad | Ninguno | Confirme uno o más objetos riskyUser como seguros. |
| Dismiss | Ninguno | Descartar el riesgo de uno o más objetos RiskyUser . |
| Historial de listas | colección riskyUserHistoryItem | Obtenga riskyUserHistoryItems de la propiedad de navegación history. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Identificador único del usuario en riesgo. |
| isDeleted | Booleano | Indica si se elimina el usuario. Los valores posibles son: true, false. |
| isProcessing | Booleano | Indica si el back-end está procesando el estado de riesgo de un usuario. |
| riskLastUpdatedDateTime | DateTimeOffset | Fecha y hora en que se actualizó por última vez el usuario de riesgo. El tipo DateTimeOffset representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. |
| riskLevel | riskLevel | Nivel del usuario de riesgo detectado. Los valores posibles son: low, medium, high, hidden, none, unknownFutureValue. |
| riskState | riskState | Estado del riesgo del usuario. Los valores posibles son: none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised y unknownFutureValue. |
| riskDetail | riskDetail | Detalles del riesgo detectado. |
| userDisplayName | Cadena | Nombre para mostrar de usuario de riesgo. |
| userPrincipalName | Cadena | Nombre principal de usuario de riesgo. |
Relaciones
| Relación | Tipo | Description |
|---|---|---|
| historia | colección riskyUserHistoryItem | La actividad relacionada con el cambio de nivel de riesgo del usuario |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.riskyUser",
"id": "String (identifier)",
"isDeleted": "Boolean",
"isProcessing": "Boolean",
"riskLastUpdatedDateTime": "String (timestamp)",
"riskLevel": "String",
"riskState": "String",
"riskDetail": "String",
"userDisplayName": "String",
"userPrincipalName": "String"
}