更新订阅

更新 SharePoint 列表中的 webhook 订阅。

权限

下面的 SharePoint 加载项权限表 仅供旧版参考。 对 SharePoint Online Webhook 使用受支持的 Microsoft Entra 身份验证。

重要

SharePoint 加载项已于 2026 年 4 月 2 日在 SharePoint Online 中终止生命周期。 SharePoint 托管和提供程序托管的加载项均已停用,并且不再在 SharePoint Online(包括政府云)中正常工作。 保留加载项开发、部署和使用指南以供历史参考和适用的 SharePoint 服务器 方案使用,而不用于新的 SharePoint Online 解决方案。

通过本地应用目录部署的 SharePoint 服务器 加载项不会因此更改而停用。 从 SharePoint 服务器 的公共市场获取 SharePoint 加载项已于 2026 年 4 月 2 日结束。

此停用不会停用 SharePoint REST API、CSOM、JSOM 或 SharePoint 框架 (SPFx) 。 对于 SharePoint Online,请使用 SPFx 进行用户界面扩展,并使用 Microsoft Entra ID 对外部应用程序进行身份验证。 请参阅 停用公告 和 加载项迁移指南。

应用程序必须至少具有对 SharePoint 列表的编辑权限,将在该列表中对订阅进行更新。

如果你的应用程序是 Microsoft Azure Active Directory (Azure AD) 应用程序

必须授予 Azure AD 应用程序在下表中指定的权限。 只能由创建订阅的 Azure AD 应用程序来更新订阅。

应用程序 权限
Office 365 SharePoint Online 在所有网站集中读取和写入项及列表。

如果你的应用程序是 SharePoint 加载项

必须向 SharePoint 加载项授予以下权限或更高权限。 只能由创建订阅的 SharePoint 加载项来更新订阅。

范围 权限
列表 管理

HTTP 请求

PATCH _api/web/lists('list-id')/subscriptions('id')

示例

PATCH _api/web/lists('5C77031A-9621-4DFC-BB5D-57803A94E91D')/subscriptions('6D77031A-2345-5GRT-BV3D-55234B56FR43')
Content-Type: application/json

{
  "notificationUrl": "https://contoso.azurewebsites.net/api/v2/webhook-receiver",
  "expirationDateTime": "2016-01-03T11:23:00.000Z"
}

请求正文

请求正文中包含以下属性。

名称 类型 说明
notificationUrl string 向其发送通知的服务 URL。
expirationDateTime date 通知将过期并被删除的日期。
clientState string 可选。 传递回所有通知上的客户端的不透明字符串。
可以使用它对通知进行验证,或标记不同的订阅。

响应

如果找到并成功更新订阅,则返回 204 No Content 响应。

示例

HTTP/1.1 204 No Content

另请参阅