更新订阅

项目
04/08/2023

更新 SharePoint 列表中的 webhook 订阅。

Permissions

应用程序必须至少具有对 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

通过