Actualizar un elemento en una lista

Actualice las propiedades de un recurso listItem.

Permisos

Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso	Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa)	Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitida.
Aplicación	Sites.ReadWrite.All

Solicitud HTTP

PATCH /sites/{site-id}/lists/{list-id}/items/{item-id}/fields

Encabezados de solicitud opcionales

Nombre	Valor	Descripción
if-match	etag	Si se incluye el encabezado de la solicitud y la ETag proporcionada no coincide con la ETag actual del elemento, se devuelve una respuesta 412 Precondition Failed y el elemento no se actualizará.

Cuerpo de solicitud

En el cuerpo de la solicitud, proporcione una representación JSON de un recurso fieldValueSet especificando los campos que quiere actualizar.

Ejemplo

Aquí tiene un ejemplo que actualiza los campos Color y Quantity (Cantidad) del elemento de lista con los nuevos valores. Todos los demás valores de listItem quedan solos.

PATCH /sites/{site-id}/lists/{list-id}/items/{item-id}/fields
Content-Type: application/json

{
    "Color": "Fuchsia",
    "Quantity": 934
}

Respuesta

Si se realiza correctamente, este método devuelve un valor fieldValueSet en el cuerpo de la respuesta del elemento de lista actualizado.

HTTP/1.1 201 Created
Content-type: application/json

{
  "Name": "Widget",
  "Color": "Fuchsia",
  "Quantity": 934
}