ListItem aktualisierenUpdate listItem

Aktualisieren Sie die Eigenschaften in einem listItem.Update the properties on a listItem.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Sites.ReadWrite.AllSites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Sites.ReadWrite.AllSites.ReadWrite.All

HTTP-AnforderungHTTP request

Aktualisieren Sie die Eigenschaften in einem listItem.Update the properties on a listItem.

PATCH https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items/{item-id}

Aktualisieren Sie die Spaltenwerte in einem listItem.Update column values on a listItem.

PATCH https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items/{item-id}/fields

Optionale AnforderungsheaderOptional request headers

NameName WertValue BeschreibungDescription
if-matchif-match etagetag 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.If this request header is included and the eTag provided does not match the current eTag on the item, a 412 Precondition Failed response is returned and the item will not be updated.

AnforderungstextRequest body

Geben Sie im Textbereich eine JSON-Darstellung von einem FieldValueSet an, um die Felder für die Aktualisierung anzugeben.In the request body, supply a JSON representation of a fieldValueSet specifying the fields to update.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 201 Created und ein fieldValueSet-Objekt im Antworttext des aktualisierten Listenelements zurückgegeben.If successful, this method returns a 201 Created response code and a fieldValueSet in the response body for the updated list item.

BeispielExample

Im folgenden Beispiel werden die Felder Farbe und Menge des Listenelements mit neuen Werten aktualisiert.The following example updates the Color and Quantity fields of the list item with new values. Alle anderen Werte des listItem bleiben unberührt.All other values on the listItem are left alone.

AnforderungRequest

PATCH https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items/{item-id}/fields
Content-Type: application/json

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

AntwortResponse

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

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