Удаление ресурса DriveItem
Удаление ресурса DriveItem по идентификатору или пути. Обратите внимание, что при удалении элементов с помощью этого метода элементы перемещаются в корзину, а не удаляются безвозвратно.
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения | Разрешения (в порядке повышения привилегий) |
---|---|
Делегированные (рабочая или учебная учетная запись) | Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | 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
Ответы с ошибками
Дополнительные сведения о возвращении ошибок см. в статье Ответы с ошибками.