删除 DriveItem
通过使用其 ID 或路径删除 DriveItem。 注意,使用此方法删除项将把项移动到回收站中,而不是永久删除该项。
权限
调用此 API 需要以下权限之一。 若要了解详细信息,包括如何选择权限的信息,请参阅权限。
权限类型 | 权限(从最低特权到最高特权) |
---|---|
委派(工作或学校帐户) | Files.ReadWrite、Files.ReadWrite.All、Sites.ReadWrite.All |
委派(个人 Microsoft 帐户) | Files.ReadWrite、Files.ReadWrite.All |
应用程序 | Files.ReadWrite.All、Sites.ReadWrite.All |
HTTP 请求
DELETE /drives/{drive-id}/items/{item-id}
DELETE /groups/{group-id}/drive/items/{item-id}
DELETE /me/drive/items/{item-id}
DELETE /sites/{siteId}/drive/items/{itemId}
DELETE /users/{userId}/drive/items/{itemId}
可选的请求标头
名称 | 类型 | 说明 |
---|---|---|
if-match | String | 如果包含此请求标头,且提供的 eTag(或 cTag)与项中的当前标记不匹配,则返回 412 Precondition Failed 响应,并且不会删除该项。 |
示例
下面是一个如何调用此 API 的示例。
DELETE /me/drive/items/{item-id}
响应
如果成功,此调用将返回 204 No Content
响应,以指明资源已被删除,没有可返回的内容。
HTTP/1.1 204 No Content
错误响应
请参阅错误响应,详细了解错误返回方式。