Element in einer Liste aktualisieren

Artikel
04/08/2023

Aktualisieren Sie die Eigenschaften in einem listItem.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Sites.ReadWrite.All

HTTP-Anforderung

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

Optionale Anforderungsheader

Name	Wert	Beschreibung
if-match	etag	Wenn dieser Anforderungsheader enthalten ist und das angegebene eTag nicht mit dem aktuellen Tag des Elements übereinstimmt, wird die Antwort `412 Precondition Failed` zurückgegeben, und das Element wird nicht aktualisiert.

Anforderungstext

Geben Sie im Textbereich eine JSON-Darstellung von einem FieldValueSet an, um die Felder für die Aktualisierung anzugeben.

Beispiel

Dies ist ein Beispiel für die Aktualisierung der Felder Farbe und Menge Felder des Listenelements mit neuen Werten. Alle anderen Werte des listItem bleiben unberührt.

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

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

Antwort

Wenn die Methode erfolgreich verläuft, wird ein fieldValueSet-Objekt im Antworttext des aktualisierten Listenelements zurückgegeben.

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

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

Freigeben über