Atualizar assinatura

Artigo
04/08/2023

Renove uma assinatura ampliando seu tempo de validade.

As assinaturas a recursos expiram nas datas prescritas pelos tipos de recursos individuais. Para não perder as notificações, as assinaturas devem ser renovadas bem antes de sua data de vencimento. Consulte subscription para saber mais sobre datas de vencimento individuais.

Permissões

Uma das permissões a seguir é necessária para chamar essa API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Aplicativo	Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Solicitação HTTP

PATCH /subscriptions/{id}

Exemplo

Solicitação

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

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

Resposta

Se a assinatura for corrigida com êxito, o objeto de assinatura resultante será retornado:

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

Respostas de erros

Confira mais informações sobre como os erros são retornados em Respostas de Erros.

Compartilhar via