Обновление подписки
Обновляет подписку на веб-перехватчики для списка SharePoint.
Разрешения
Приложение должно иметь по крайней мере разрешение на изменение списка SharePoint, в котором обновляется подписка.
Если приложение является приложением Microsoft Azure Active Directory (AD)
Приложению Azure AD необходимо предоставить разрешения, указанные в таблице ниже. Подписку можно обновить только из приложения Azure AD, в котором она создана.
| Приложение | Разрешение |
|---|---|
| SharePoint Online в Office 365 | Чтение и запись элементов и списков во всех семействах веб-сайтов. |
Если приложение является надстройкой 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 | строка | URL-адрес службы для отправки уведомлений. |
| expirationDateTime | дата | Срок хранения уведомления. |
| clientState | string | Необязательный. Непрозрачная строка, которая передается клиенту со всеми уведомлениями. Ее можно использовать для проверки уведомлений или маркировки различных подписок. |
Ответ
Если подписка найдена и успешно обновлена, возвращается ответ 204 No Content.
Пример
HTTP/1.1 204 No Content