Element aus einer Liste löschenDelete an item from a list

Entfernt ein Element aus einer Liste.Removes an item from a list.

BerechtigungenPermissions

Damit ein Element gelöscht werden kann, muss der Benutzer der Anwendung Schreibzugriff auf das zu löschende Element gewährt haben.To delete an item, the user must have granted the application write access to the item to be deleted.

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

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

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 gelöscht.If this request header is included and the eTag provided does not match the current tag on the item, a 412 Precondition Failed response is returned and the item will not be deleted.

AnforderungstextRequest body

Bei dieser Methode wird kein Anforderungstext angegeben.Do not supply a request body with this method.

BeispielExample

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

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird die Antwort 204 No Content zurückgegeben, um anzugeben, dass die Ressource gelöscht wurde und keine Werte zum Zurückgeben vorhanden waren.If successful, this call returns a 204 No Content response to indicate that resource was deleted and there was nothing to return.

HTTP/1.1 204 No Content