从列表中删除项
从 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