Aktualisieren eines Abonnements

  • Artikel

Aktualisiert ein Webhook-Abonnement in einer SharePoint-Liste.

Berechtigungen

Die Anwendung muss mindestens Bearbeitenberechtigungen für die SharePoint-Liste haben, in der das Abonnement aktualisiert wird.

Wenn es sich bei Ihrer Anwendung um eine Microsoft Azure Active Directory (Azure AD)-Anwendung handelt

Sie müssen der Azure AD-Anwendung die in der folgenden Tabelle angegebenen Berechtigungen erteilen. Ein Abonnement kann nur von der Azure AD-Anwendung, die es erstellt hat, aktualisiert werden.

Anwendung Berechtigung
Office 365 SharePoint Online Lese-/Schreibzugriff auf Elemente und Listen in allen Websitesammlungen.

Wenn es sich bei Ihrer Anwendung um ein SharePoint-Add-In handelt

Sie müssen dem SharePoint-Add-In mindestens die folgenden Berechtigungen erteilen. Ein Abonnement kann nur von dem SharePoint-Add-In, das es erstellt hat, aktualisiert werden.

Umfang Berechtigungen
Auflisten Verwalten

HTTP-Anforderung

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

Beispiel

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"
}

Anforderungstext

Schließen Sie die folgenden Eigenschaften in die Anforderung ein.

Name Typ Beschreibung
notificationUrl string Die Dienst-URL, an den Benachrichtigungen gesendet werden.
expirationDateTime date Das Datum, an dem die Benachrichtigung abläuft und gelöscht wird.
clientState string Optional. Verschlüsselte Zeichenfolge, die bei allen Benachrichtigungen zurück an den Client übergeben wird.
Dies können Sie zum Überprüfen von Benachrichtigungen oder zum Kategorisieren unterschiedlicher Abonnements verwenden.

Antwort

Wenn das Abonnement gefunden und erfolgreich aktualisiert wird, wird eine 204 No Content-Antwort zurückgegeben.

Beispiel

HTTP/1.1 204 No Content

Siehe auch