Abonnement aktualisieren

Artikel
04/08/2023

Erneuert ein Abonnement durch Verlängern seiner Ablaufzeit.

Abonnements für Ressourcen laufen an Tagen ab, die von den einzelnen Ressourcentypen vorgegeben werden. Um keine Benachrichtigungen zu verpassen, sollten Abonnements weit vor ihrem Ablaufdatum verlängert werden. Informationen zu den einzelnen Ablaufdaten finden Sie unter Abonnement.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Anwendung	Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-Anforderung

PATCH /subscriptions/{id}

Beispiel

Anforderung

PATCH /subscriptions/{id}
Content-type: application/json

{
  "expirationDateTime": "2018-01-03T11:23:00.000Z"
}

Antwort

Wenn das Abonnement erfolgreich gepatcht wurde, wird das resultierende Abonnementobjekt zurückgegeben:

HTTP/1.1 200 OK
Content-type: application/json

{
 "id": "1039149811asbc",
 "resource": "/me/drive/root",
 "changeType": "updated",
 "clientState": "subscription-identifier",
 "notificationUrl": "https://contoso.azurewebsites.net/api/v2/webhook-receiver",
 "expirationDateTime": "2018-01-03T11:23:00.000Z"
}

Fehlerantworten

Weitere Informationen dazu, wie Fehler zurückgegeben werden, finden Sie unter Fehlerantworten.

Freigeben über