从列表中删除项

list 中删除项。

权限

应用程序必须拥有用户授予的对要删除的项的写入权限,才能删除项。

调用此 API 需要以下权限之一。 若要了解详细信息,包括如何选择权限的信息,请参阅权限

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) Sites.ReadWrite.All
委派(个人 Microsoft 帐户) 不支持。
应用程序 Sites.ReadWrite.All

HTTP 请求

DELETE /sites/{site-id}/lists/{list-id}/items/{item-id}

可选的请求标头

名称 说明
if-match etag 如果包含此请求标头,且提供的 eTag 与项中的当前标记不匹配,则返回 412 Precondition Failed 响应,并且不会删除该项。

请求正文

请勿为此方法提供请求正文。

示例

DELETE /sites/{site-id}/lists/{list-id}/items/{item-id}

响应

如果成功,此调用将返回 204 No Content 响应,表示资源已被删除,没有可返回的内容。

HTTP/1.1 204 No Content