サブスクリプションを更新する

サブスクリプションを更新するには、サブスクリプションの有効期限を延長します。

リソースのサブスクリプションは、個々のリソースの種類で規定された日付になると有効期限が切れます。 通知を見逃さないようにするため、有効期限よりも前にサブスクリプションを更新する必要があります。 個々の有効期限の日付については、サブスクリプションを参照してください。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	Files.Read、Files.ReadWrite、Files.Read.All、Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All
委任 (個人用 Microsoft アカウント)	Files.Read、Files.ReadWrite、Files.Read.All、Files.ReadWrite.All
アプリケーション	Files.Read.All、Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All

HTTP 要求

PATCH /subscriptions/{id}

例

要求

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

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

応答

サブスクリプションが正常に修正されると、次に示すように、その結果のサブスクリプション オブジェクトが返されます。

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

エラー応答

エラーがどのように返されるかについては、「エラー応答」を参照してください。