tipo de recurso riskyAgent

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"
}