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

Microsoft OneDrive 事件

项目
12/12/2023

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

可用事件类型

通过使用 Microsoft Graph API 在这些资源上操作来更新 driveItem 时，将触发这些事件。

事件名称	描述
Microsoft.Graph.DriveItemUpdated	当 OneDrive for Business 中根文件夹 driveItem 的层次结构中的内容或用户的个人 OneDrive 中根文件夹或子文件夹 driveItem 的内容更新时，将触发此事件。

示例事件

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

Microsoft.Graph.DriveItemUpdated 事件

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.DriveItemUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "driveItem/<driveItem-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>",
    "clientState": "<user-provided secret>",
    "expirationDateTime": "2023-10-05T18:11:08.587Z",
    "resource": "<guid>",
    "siteUrl": "<sharepoint relative URL>",
    "webId": "<guid>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.driveItem"
    },    
  }
}

事件属性

事件具有以下顶级数据：

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

数据对象具有以下属性：

属性	类型	说明
`changeType`	字符串	资源状态更改的类型。
`resource`	字符串	针对其引发事件的资源标识符。
`tenantId`	string	保留 driveItem 的组织 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 事件网格订阅的详细信息，请参阅创建事件订阅和事件网格订阅架构。
有关如何配置事件订阅以选择要传递的特定事件的信息，请参阅事件筛选。可能还需要引用筛选事件。

通过