tipo de recurso alert (en desuso)

  • Artículo

Espacio de nombres: microsoft.graph

Nota:

La API de alertas heredada está en desuso y se quitará en abril de 2026. Se recomienda migrar a la nueva API de alertas e incidentes .

Este recurso corresponde a la primera generación de alertas en la API de seguridad de Microsoft Graph, que representa posibles problemas de seguridad dentro del inquilino de un cliente que Microsoft o una solución de seguridad de asociado identifica.

Este tipo de alertas federa las llamadas de los proveedores de seguridad de Azure y Microsoft 365 Defender admitidos que aparecen en Uso de la API de seguridad de Microsoft Graph. Agrega datos de alerta comunes entre los distintos dominios para permitir que las aplicaciones unifiquen y optimicen la administración de problemas de seguridad en todas las soluciones integradas.

Para obtener más información, vea las consultas de ejemplo en el Probador de Graph.

Nota:

Este recurso es uno de los dos tipos de alertas que ofrece la versión v1.0 de la API de seguridad de Microsoft Graph. Para obtener más información, consulte alertas.

Métodos

Método Tipo de valor devuelto Descripción
Obtener alerta alert Lee las propiedades y relaciones de un objeto alert.
Actualizar alerta alert Actualiza un objeto alert.
Enumerar alertas Colección alert Obtiene una colección de objetos alert.

Propiedades

Propiedad Tipo Descripción
activityGroupName String Nombre o alias del grupo de actividades (atacante) al cual se atribuye esta alerta.
assignedTo String Nombre del analista al cual la alerta está asignada para evaluación, investigación o corrección (admite actualización).
azureSubscriptionId String Identificador de suscripción de Azure, presente si esta alerta está relacionada con un recurso de Azure.
azureTenantId String Microsoft Entra identificador de inquilino. Obligatorio.
categoría Cadena Categoría de la alerta (por ejemplo, credentialTheft, ransomware).
closedDateTime DateTimeOffset Hora en que se cerró la alerta. El tipo de marca de tiempo 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 actualización).
cloudAppStates Colección cloudAppSecurityState Información de estado relacionada con la seguridad generada por el proveedor acerca de las aplicaciones en la nube sobre esta alerta.
comments Colección String Comentarios proporcionados por el cliente sobre la alerta (para la administración de alertas del cliente) (admite actualización).
confidence Int32 Confidence de la lógica de detección (porcentaje entre 1 y 100).
createdDateTime DateTimeOffset Hora en que el proveedor creó la alerta. El tipo de marca de tiempo 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. Obligatorio.
description String Descripción de la alerta.
detectionIds Colección String Conjunto de alertas relacionadas con esta entidad alert (cada alerta se envía al SIEM como registro independiente).
eventDateTime DateTimeOffset Hora a la que se produjo el evento o los eventos que sirvieron como desencadenador para generar la alerta. El tipo de marca de tiempo 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. Obligatorio.
feedback alertFeedback Comentarios del analista sobre la alerta. Los valores posibles son: unknown, truePositive, falsePositive y benignPositive. Admite la actualización.
fileStates Colección fileSecurityState Información de estado relacionada con la seguridad generada por el proveedor acerca de los archivos en relación con esta alerta.
hostStates Colección hostSecurityState Información de estado relacionada con la seguridad generada por el proveedor acerca de los hosts en relación con esta alerta.
id String GUID o identificador único generado por el proveedor. Solo lectura. Obligatorio.
incidentIds Colección de cadena Id. de incidentes relacionados con la alerta actual.
lastModifiedDateTime DateTimeOffset Hora en que se modificó por última vez la entidad alert. El tipo de marca de tiempo 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.
malwareStates Colección malwareState Inteligencia de amenazas que pertenezcan a malware relacionado con esta alerta.
networkConnections Colección networkConnection Información de estado relacionada con la seguridad generada por el proveedor acerca de las conexiones de red de esta alerta.
procesos Colección process Información de estado relacionada con la seguridad generada por el proveedor acerca del proceso o procesos relacionados con esta alerta.
recommendedActions Colección String Acciones para realizar recomendadas por el proveedor como resultado de la alerta (por ejemplo, aislar equipo, enforce2FA, volver a crear una imagen del host).
registryKeyStates Colección registryKeyState Información de estado relacionada con la seguridad generada por el proveedor acerca de las claves del registro sobre esta alerta.
securityResources Colección securityResource Recursos relacionados con la alerta actual. Por ejemplo, en algunas alertas, esto puede tener el valor del recurso de Azure.
severity alertSeverity Gravedad de las alertas: establecida por el proveedor. Los valores posibles son: unknown, informational, low, medium y high. Obligatorio.
sourceMaterials Colección String Hipervínculos (URI) al material de origen relacionado con la alerta, por ejemplo, la interfaz de usuario del proveedor para las alertas o la búsqueda de registros.
status alertStatus Estado del ciclo de vida de la alerta (fase). Los valores posibles son: unknown, newAlert, inProgress y resolved. (admite actualización). Obligatorio.
tags Colección string Etiquetas definibles por el usuario que se pueden aplicar a una alerta y pueden servir como condiciones de filtro (por ejemplo, "HVA", "SAW") (admite la actualización).
title String Título de la alerta. Obligatorio.
triggers Colección alertTrigger Información de seguridad sobre las propiedades específicas que desencadenaron la alerta (las propiedades que aparecen en la alerta). Las alertas pueden contener información sobre múltiples usuarios, hosts, archivos y direcciones IP. Este campo indica qué propiedades desencadenaron la generación de la alerta.
userStates Colección userSecurityState Información de estado relacionada con la seguridad generada por el proveedor acerca de las cuentas de usuario relacionadas con esta alerta.
vendorInformation securityVendorInformation Tipo complejo que contiene detalles sobre el proveedor del producto o servicio de seguridad y proveedor y subproveedor (por ejemplo, proveedor=Microsoft; proveedor=Windows Defender ATP; subproveedor=AppLocker). Obligatorio.
vulnerabilityStates Colección vulnerabilityState Inteligencia de amenazas que pertenezcan a una o más vulnerabilidades relacionadas con esta alerta.

Relaciones

Ninguna.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "activityGroupName": "String",
  "assignedTo": "String",
  "azureSubscriptionId": "String",
  "azureTenantId": "String",
  "category": "String",
  "closedDateTime": "String (timestamp)",
  "cloudAppStates": [{"@odata.type": "microsoft.graph.cloudAppSecurityState"}],
  "comments": ["String"],
  "confidence": 1024,
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "detectionIds": ["String"],
  "eventDateTime": "String (timestamp)",
  "feedback": "@odata.type: microsoft.graph.alertFeedback",
  "fileStates": [{"@odata.type": "microsoft.graph.fileSecurityState"}],
  "hostStates": [{"@odata.type": "microsoft.graph.hostSecurityState"}],
  "id": "String (identifier)",
  "incidentIds": ["String"],
  "lastModifiedDateTime": "String (timestamp)",
  "malwareStates": [{"@odata.type": "microsoft.graph.malwareState"}],
  "networkConnections": [{"@odata.type": "microsoft.graph.networkConnection"}],
  "processes": [{"@odata.type": "microsoft.graph.process"}],
  "recommendedActions": ["String"],
  "registryKeyStates": [{"@odata.type": "microsoft.graph.registryKeyState"}],
  "securityResources": [{"@odata.type": "microsoft.graph.securityResource"}],
  "severity": "@odata.type: microsoft.graph.alertSeverity",
  "sourceMaterials": ["String"],
  "status": "@odata.type: microsoft.graph.alertStatus",
  "tags": ["String"],
  "title": "String",
  "triggers": [{"@odata.type": "microsoft.graph.alertTrigger"}],
  "userStates": [{"@odata.type": "microsoft.graph.userSecurityState"}],
  "vendorInformation": {"@odata.type": "microsoft.graph.securityVendorInformation"},
  "vulnerabilityStates": [{"@odata.type": "microsoft.graph.vulnerabilityState"}]
}