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

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

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

Запрос удаления следует отправлять с помощью метода 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
}