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

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

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

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

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

URL. Может быть шаблонизирован, см. ключ templated.

method

HTTP-метод для запроса URL из ключа href.

templated

Признак URL, который был шаблонизирован согласно RFC 6570. Возможные значения:

  • «true» — URL шаблонизирован: прежде чем отправлять запрос на этот адрес, следует указать нужные значения параметров вместо значений в фигурных скобках.
  • «false» — URL может быть запрошен без изменений.