删除 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

错误响应

请参阅错误响应,详细了解错误返回方式。