Azure Event Grid Graph API SharePoint事件为何缺少列表项ID等关键信息？

你遇到的问题是因为Event Grid订阅的配置未开启资源数据包含，或权限、事件类型配置不当，导致仅返回基础事件元数据，没有列表项的具体信息。以下是具体的排查和修复步骤：

1. 确认Event Grid订阅的事件类型与资源范围 #

• 确保你创建的Event Grid订阅针对的是列表项级别的事件（Microsoft.Graph.ListItemCreated/Microsoft.Graph.ListItemUpdated），而非列表级别的事件。如果订阅的是列表级事件，只会返回列表本身的信息，不会包含具体项的ID或字段数据。
• 检查订阅的目标资源是否指向正确的SharePoint列表，确认资源路径无误。

2. 开启订阅的「包含资源数据」选项 #

这是核心配置项，决定事件是否返回具体的资源详情：

• Azure门户操作：在事件订阅的「附加设置」中，勾选「包含资源数据」选项；
• PowerShell/CLI操作：创建订阅时添加对应参数（PowerShell：-IncludeResourceData $true；Azure CLI：--include-resource-data true）；
• ARM模板/API请求：在订阅的JSON定义中设置"includeResourceData": true。

开启后，事件的resourceData字段会包含列表项的ID、ETag、字段值等关键数据，示例如下：

"data": {
    "subscriptionId": "XXX",
    "clientState": "",
    "resource": "/sites/SITEID/lists/EventGridTriggerTest/items/123",
    "tenantId": "TENANTID",
    "resourceData": {
        "@odata.type": "#Microsoft.Graph.ListItem",
        "id": "123",
        "etag": "\"W/\\\"XXX\\\"\"",
        "fields": {
            "Title": "测试列表项",
            "Created": "2024-10-22T21:28:52Z"
        }
    },
    "subscriptionExpirationDateTime": "2024-11-29T19:40:37.891+00:00",
    "changeType": "updated"
}

3. 验证事件源应用的Graph权限 #

合作伙伴主题依赖Microsoft Graph获取事件数据，需确保事件源对应的应用注册（即你收到的事件source字段中的应用）拥有足够权限：

• 授予Sites.Read.All或Sites.ReadWrite.All的应用权限（注意是应用权限，而非委派权限）；
• 确保已完成管理员同意流程，权限处于生效状态。

4. 确认订阅的ChangeType匹配需求 #

你提到要捕获列表项创建事件，但当前收到的事件changeType为updated，需检查订阅的ChangeType是否包含created，避免漏订阅目标事件类型。

内容的提问来源于stack exchange，提问作者J James