Mettre à jour un élément dans une liste

Article
04/08/2023

Mettez à jour les propriétés sur une ressource listItem.

Autorisations

L’une des autorisations suivantes est requise pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	Sites.ReadWrite.All
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	Sites.ReadWrite.All

Requête HTTP

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

En-têtes de demande facultatifs

Nom	Valeur	Description
if-match	etag	Si cet en-tête de demande est inclus et que l’eTag fourni ne correspond pas à l’eTag actuellement appliqué à l’élément, une réponse `412 Precondition Failed` est renvoyée et l’élément n’est pas mis à jour.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON d’une ressource fieldValueSet indiquant les champs à mettre à jour.

Exemple

Voici un exemple qui met à jour les champs Couleur et Quantité de l’élément de liste avec de nouvelles valeurs. Toutes les autres valeurs sur la ressource listItem restent inchangées.

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

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

Réponse

Si elle réussit, cette méthode renvoie une ressource fieldValueSet dans le corps de la réponse pour l’élément de liste mis à jour.

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

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

Partager via