Удаление файла или папки

Удалять файлы и папки на Диске пользователя можно, указывая путь к удаляемому ресурсу. Помните, что перемещение ресурсов в Корзину никак не влияет на доступное место на Диске. Чтобы освободить место, следует также удалять ресурсы из Корзины.

Формат запросаФормат запроса

Запрос удаления следует отправлять с помощью метода DELETE.

https://cloud-api.yandex.net/v1/disk/resources
 ? path=<путь к удаляемому ресурсу>
 & [permanently=<признак безвозвратного удаления>]
 & [fields=<свойства, которые нужно включить в ответ>]

path*

Путь к удаляемому ресурсу. Например, $2Ffoo%2Fphoto.png.

Путь в значении параметра следует кодировать в URL-формате.

permanently

Признак безвозвратного удаления. Поддерживаемые значения:

• false — удаляемый файл или папка перемещаются в Корзину (используется по умолчанию).
• true — файл или папка удаляются без помещения в Корзину.

fields

Список свойств JSON, которые следует включить в ответ. Ключи, не указанные в этом списке, будут отброшены при составлении ответа. Если параметр не указан, ответ возвращается полностью, без сокращений.

Имена ключей следует указывать через запятую, а вложенные ключи разделять точками. Например: name,_embedded.items.path.

* Обязательный параметр.

Формат ответаФормат ответа

Если запрос был обработан без ошибок, API составляет тело ответа в зависимости от вида указанного ресурса — ответ для пустой папки или файла отличается от ответа для непустой папки.

Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит описание ошибки.

Файл или пустая папкаФайл или пустая папка

API отвечает кодом 204 No content (ресурс успешно удален) без тела ответа.

Непустая папкаНепустая папка

Непустая папка может удаляться в течение произвольного времени, поэтому API отвечает кодом 202 Accepted (удаление папки начато).

Приложения должны самостоятельно следить за статусами запрошенных операций. API возвращает ссылку на статус запущенной по запросу операции в теле ответа в объекте Link.

Пример ответа:

{
  "href": "https://cloud-api.yandex.net/v1/disk/operations?id=d80c269ce4eb16c0207f0a15t4a31415313452f9e950cd9576f36b1146ee0e42",
  "method": "GET",
  "templated": false
}