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

Microsoft OneDrive 事件

本文提供 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 租户标识符。

后续步骤