Compartir a través de

Actualizar una suscripción

  • Artículo

Actualiza una suscripción de webhook en una lista de SharePoint.

Permisos

La aplicación debe tener al menos permisos de edición en la lista de SharePoint donde se actualizará la suscripción.

Si la aplicación es una aplicación de Microsoft Azure Active Directory (Azure AD)

Debe conceder a la aplicación de Azure AD los permisos que se especifican en la siguiente tabla. La aplicación de Azure AD que ha creado la suscripción es la única que la puede actualizar.

Aplicación Permiso
Office 365 SharePoint Online Leer y escribir elementos y listas en todas las colecciones de sitios.

Si la aplicación es un complemento de SharePoint

Debe conceder al complemento de SharePoint los siguientes permisos u otros superiores. El complemento de SharePoint que ha creado la suscripción es el único que la puede actualizar.

Ámbito Derechos de permiso
Lista Administrar

Solicitud HTTP

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

Ejemplo

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

Cuerpo de la solicitud

Incluya las siguientes propiedades en el cuerpo de la solicitud.

Nombre Tipo Descripción
notificationUrl string La dirección URL del servicio a la que se van a enviar las notificaciones.
expirationDateTime date La fecha en que expirará la notificación y se eliminará.
clientState string Opcional. Cadena opaca que se ha pasado al cliente en todas las notificaciones.
Puede usarla para validar las notificaciones o etiquetar suscripciones diferentes.

Respuesta

Si la suscripción se encuentra y se actualiza correctamente, se devuelve una respuesta 204 No Content.

Ejemplo

HTTP/1.1 204 No Content

Consulte también