Element in einer Liste aktualisierenUpdate an item in a list

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

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

PATCH https://graph.microsoft.com/beta/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.

BeispielExample

Dies ist ein Beispiel für die Aktualisierung der Felder Farbe und Menge Felder des Listenelements mit neuen Werten.Here is an example that 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.

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

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

AntwortResponse

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

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

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