你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Microsoft 安全警报事件

项目
12/12/2023

本文提供 Microsoft Graph API 发布的 Microsoft 安全警报事件的属性和架构。有关事件架构的简介，请参阅 CloudEvents 架构。

可用事件类型

使用 Microsoft Graph API 通过对这些资源进行操作来创建安全警报时，将触发这些事件。

事件名称	描述
Microsoft.Graph.AlertCreated	在 Microsoft 安全中创建新警报时触发。

示例事件

触发某个事件后，事件网格服务会将有关该事件的数据发送到订阅目标。本部分包含每个 Microsoft 安全警报事件的数据外观示例。

Microsoft.Graph.AlertCreated 事件

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.AlertCreated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "Alert/<alert-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "subscriptionId":  "<guid>",
    "resource": "<alert-id>",
    "changeType": "updated",
    "clientState": "<guid>",
    "notificationUrl":  "<target-Url>",
    "expirationDateTime": "2023-10-01T06:21:57-07:00",
    "resourceData": {
      "id": "<alert-id>",
      "@odata.id": "security/<id>",
      "@odata.type": "#IsgWebApi.SecurityGraphModel.<id>",      
    },
    "subscriptionExpirationDateTime": "2022-05-24T23:21:19.3554403+00:00",
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>
  }
}

事件属性

事件具有以下顶级数据：

属性	类型	说明
`source`	字符串	租户事件源。此字段不可写入。 Microsoft Graph API 提供此值。
`subject`	string	事件主题的发布者定义路径。
`type`	string	此事件源的事件类型之一。
`time`	字符串	事件的生成时间，基于提供程序的 UTC 时间
`id`	字符串	事件的唯一标识符。
`data`	object	提供有关资源状态更改的数据的事件有效负载。
`specversion`	字符串	CloudEvents 架构规范版本。

数据对象具有以下属性：

属性	类型	说明
`changeType`	字符串	资源状态更改的类型。
`resource`	字符串	针对其引发事件的资源标识符。
`tenantId`	string	引发警报的组织 ID。
`clientState`	string	创建 Graph API 订阅时由用户提供的机密。
`@odata.type`	字符串	Graph API 更改类型。
`@odata.id`	字符串	针对其引发事件的 Graph API 资源标识符。
`id`	字符串	针对其引发事件的资源标识符。
`subscriptionExpirationDateTime`	string	RFC 3339 格式的 Graph API 订阅过期时间。
`subscriptionId`	字符串	Graph API 订阅标识符。
`tenantId`	string	Microsoft Entra 租户标识符。

后续步骤

有关 Azure 事件网格合作伙伴事件的简介，请参阅合作伙伴事件概述
有关如何订阅 Microsoft Graph API 以接收事件的信息，请参阅订阅 Microsoft Graph API 事件。
有关 Azure 事件网格事件处理程序的信息，请参阅事件处理程序。
有关如何创建 Azure 事件网格订阅的详细信息，请参阅创建事件订阅和事件网格订阅架构。
有关如何配置事件订阅以选择要传递的特定事件的信息，请参阅事件筛选。可能还需要引用筛选事件。

通过