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
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Representa los agentes de Microsoft Entra que están en riesgo, evaluados por la protección de Microsoft Entra ID en función de diversas señales y aprendizaje automático. Esta API proporciona acceso mediante programación a todos los agentes en riesgo del inquilino de Microsoft Entra, el @odata.type indica el tipo exacto de este agente. Los tipos admitidos son riskyAgentIdentity, riskyAgentIdentityBlueprintPrincipal y riskyAgentUser.
Hereda de la entidad.
Methods
| Método | Tipo devuelto | Descripción |
|---|---|---|
| List | Colección riskyAgent | Obtenga una lista de los objetos riskyAgent y sus propiedades. |
| Get | riskyAgent | Lea las propiedades y relaciones del objeto riskyAgent . |
| Dismiss | Ninguno | Descartar el riesgo de uno o más objetos riskyAgent. |
| Confirmar lo que está en peligro | Ninguno | Confirme uno o varios objetos riskyAgent como comprometidos. |
| Confirmar seguro | Ninguno | Confirme uno o varios objetos riskyAgent como seguros. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| agentDisplayName | Cadena | Nombre del agente. Admite $filter (eq, startsWith). |
| blueprintId | Cadena | Identificador del plano técnico asociado al agente. Admite valores NULL. |
| id | Cadena | El identificador de objeto de riskyAgentIdentity, riskyAgentIdentityBlueprintPrincipal o riskyAgentUser. Heredado de la entidad. Admite $filter (eq, startsWith). |
| Tipo de identidad | agentIdentityType | El tipo de identidad del agente. Los valores posibles son: agentIdentity, agentUser, unknownFutureValue y agentIdentityBlueprintPrincipal Debe utilizar el encabezado de Prefer: include-unknown-enum-members solicitud para obtener el siguiente valor en esta enumeración evolutiva: agentIdentityBlueprintPrincipal. Obligatorio. Admite $filter (eq). |
| isDeleted | Booleano | Indica si se ha eliminado el agente. |
| isEnabled | Boolean | Indica si el agente está habilitado. |
| isProcessing | Booleano | Indica si el estado de riesgo de un agente se está procesando en el back-end. |
| riskDetail | riskDetail | Detalles del riesgo detectado del agente. Admite $filter (eq). |
| riskLastModifiedDateTime | DateTimeOffset | La fecha y hora en que se actualizó por última vez el agente 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 UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z. Admite $filter (eq, le, y ge). |
| riskLevel | riskLevel | Nivel del agente de riesgo detectado. Los valores posibles son: low, medium, high, hidden, none, unknownFutureValue. Admite $filter (eq). |
| riskState | riskState | Estado del riesgo del agente. Los valores posibles son: none, confirmedSafe, dismissed, atRisk, confirmedCompromised, unknownFutureValue. Admite $filter (eq). |
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.riskyAgent",
"id": "String (identifier)",
"agentDisplayName": "String",
"blueprintId": "String",
"identityType": "String",
"isDeleted": "Boolean",
"isEnabled": "Boolean",
"isProcessing": "Boolean",
"riskLastModifiedDateTime": "String (timestamp)",
"riskState": "String",
"riskLevel": "String",
"riskDetail": "String"
}