tipo de recurso de alerta (preterido)

Namespace: microsoft.graph

Observação

A API de alertas herdados está preterida e será removida até abril de 2026. Recomendamos que você migre para a nova API de alertas e incidentes .

Esse recurso corresponde à primeira geração de alertas na API de segurança do Microsoft Graph, representando possíveis problemas de segurança no locatário de um cliente que a Microsoft ou uma solução de segurança de parceiro identifica.

Esse tipo de alerta federa a chamada de provedores de segurança do Azure e do Microsoft 365 Defender com suporte listados em Usar a API de segurança do Microsoft Graph. Ele agrega dados de alerta comuns entre os diferentes domínios para permitir que os aplicativos unifiquem e agilizem o gerenciamento de problemas de segurança em todas as soluções integradas.

Para saber mais, veja exemplos de consulta no Explorador de Gráfico.

Observação

Esse recurso é um dos dois tipos de alertas que a versão v1.0 da API de segurança do Microsoft Graph oferece. Para obter mais informações, confira alertas.

Métodos

Método	Tipo de retorno	Descrição
Obter alerta	alert	Leia as propriedades e os relacionamentos do objeto de alerta.
Atualizar alertas	alert	Atualize um objeto de alerta.
Listar alertas	conjunto alerta	Obtenha uma coleção de objetos de alerta.

Propriedades

Propriedade	Tipo	Descrição
activityGroupName	String	Nome ou alias do grupo de atividades (invasor) a que este alerta é atribuído.
assignedTo	String	Nome do analista ao qual o alerta está atribuído para triagem, investigação ou remediação (suporta atualização).
azureSubscriptionId	String	ID da assinatura do Azure, presente se o alerta estiver relacionado a um recurso do Azure.
azureTenantId	String	Microsoft Entra ID do locatário. Obrigatório.
category	Cadeia de caracteres	Categoria do alerta (por exemplo, credentialTheft, ransomware).
closedDateTime	DateTimeOffset	Tempo em que o alerta foi fechado. O tipo Timestamp 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 (suporta atualização).
cloudAppStates	conjunto cloudAppSecurityState	Informações com estado relacionadas à segurança geradas pelo provedor sobre os aplicativos de nuvem relacionados a esse alerta.
comentários	String collection	Comentários fornecidos pelo cliente no alerta (gerenciamento de alerta de cliente) (suporta atualização).
confidence	Int32	Confiança da lógica de detecção (porcentagem entre 1 e 100).
createdDateTime	DateTimeOffset	Hora em que o alerta foi criado pelo provedor de alerta. O tipo Timestamp 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. Obrigatório.
description	String	Descrição de alerta.
detectionIds	String collection	Conjunto de alertas relacionados a essa entidade de alerta (cada alerta é enviado ao SIEM como um registro separado).
eventDateTime	DateTimeOffset	Tempo em que o evento ou eventos que serviram como o gatilho para gerar o alerta ocorreu. O tipo Timestamp 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. Obrigatório.
comentários	alertFeedback	Comentários do analista no alerta. Os valores possíveis são: unknown, truePositive, falsePositive, benignPositive. Dá suporte à atualização.
fileStates	fileSecurityState	Informações com estado relacionadas à segurança geradas pelo provedor sobre os arquivos relacionados a esse alerta.
hostStates	Conjunto hostSecurityState	Informações com estado relacionadas à segurança geradas pelo provedor sobre o(s) host(s) relacionados a esse alerta.
id	String	Identificador GUID/exclusivo gerado pelo provedor. Somente leitura. Obrigatório.
incidentIds	Coleção de cadeias de caracteres	IDs de incidentes relacionados ao alerta atual.
lastModifiedDateTime	DateTimeOffset	Hora na qual entidade alerta foi modificada pela última vez. O tipo Timestamp 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.
malwareStates	conjunto malwareState	Inteligência contra ameaças referentes ao malware relacionado a esse alerta.
networkConnections	conjunto networkConnection	Informações com estado relacionadas à segurança geradas pelo provedor sobre as conexões de rede relacionadas a esse alerta.
processos	conjunto processo	Informações com estado relacionadas à segurança geradas pelo provedor sobre o processo ou processos relacionados a esse alerta.
recommendedActions	String collection	Ações recomendadas pelo provedor/fornecedor a serem tomadas como resultado do alerta (por exemplo, isolar máquina, enforce2FA, host de imagem de imagem).
registryKeyStates	conjunto registryKeyState	Informações com estado relacionadas à segurança geradas pelo provedor sobre as chaves de registro relacionadas a esse alerta.
securityResources	Coleção de securityResource	Recursos relacionados ao alerta atual. Por exemplo, para alguns alertas, isso pode ter o valor de recurso do Azure.
severity	alertSeverity	Gravidade de alerta, definida pelo provedor/fornecedor. Os valores possíveis são: unknown, informational, low, medium, high. Obrigatório.
sourceMaterials	String collection	Hiperlinks (URIs) para o material de origem relacionado ao alerta, por exemplo, a interface do usuário do provedor para alertas ou pesquisa de log.
status	alertStatus	Status de alerta de ciclo de vida (estágio). Os valores possíveis são: unknown, newAlert, inProgress, resolved. (suporta atualização). Obrigatório.
marcações	String collection	Rótulos defiráveis pelo usuário que podem ser aplicados a um alerta e podem servir como condições de filtro (por exemplo, "HVA", "SAW") (dá suporte à atualização).
title	String	Título do alerta. Obrigatório.
gatilhos	Conjunto alertTrigger	Informações de segurança sobre propriedades específicas que dispararam o alerta (Propriedades aparecendo no alerta). Os alertas podem conter informações sobre vários usuários hosts, arquivos, endereços ip. Este campo indica quais propriedades acionaram a geração de alertas.
userStates	Conjunto userSecurityState	Informações com estado relacionadas à segurança geradas pelo provedor sobre as contas de usuários relacionadas a esse alerta.
vendorInformation	securityVendorInformation	Tipo complexo que contém detalhes sobre o fornecedor, provedor e subprovedor de produtos / serviços de segurança (por exemplo, fornecedor = Microsoft; provedor = Windows Defender ATP; subProvedor = AppLocker). Obrigatório.
vulnerabilityStates	conjunto vulnerabilityState	Inteligência de ameaças referente a uma ou mais vulnerabilidades relacionadas a este alerta.

Relações

Nenhum

Representação JSON

A representação JSON a seguir mostra o 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"}]
}