Создание папки

Чтобы создать новую папку на общем диске, укажите в запросе требуемый путь к ней.

Метод могут использовать как администраторы, так и другие сотрудники организации, у которых есть права на запись данных на общий диск.

Для OAuth-приложения необходимо наличие права:

cloud_api:disk.write

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

Метод: PUT.

https://cloud-api.yandex.net/v1/disk/virtual-disks/resources
 ? path=<путь к создаваемой папке>

Описание query-параметров

path*

Путь к создаваемой папке. Максимальная длина имени создаваемой папки — 255 символов; максимальная длина пути — 32760 символов.

Указывается в следующем формате:

vd:<vd_hash>:disk:/<путь внутри общего диска>

Где

<vd_hash> — метка общего диска. Пример vd_hash: 9Uyws5pZmXgDNA. Метку общего диска можно получить:
- по API — с помощью метода, который возвращает информацию о статусе создания общего диска (посмотреть описание метода);
- в интерфейсе Яндекс Диска — перейдите в общий диск, метка будет указана в персональной строке после vd/.
<путь внутри общего диска> — путь до файла или папки внутри общего диска.

Например, путь до файла test_file.txt, который лежит в папке test_folder общего диска указывается так:

vd:9Uyws5pZmXgDNA:disk:/test_folder/test_file.txt

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

Authorization: OAuth <token>

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

Успешный ответ

Если запрос был обработан без ошибок, API отвечает кодом 201 Created (папка успешно создана). В теле ответа, в объекте Link, возвращается ссылка на мета-информацию о созданном ресурсе.

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

{
  "href": "https://cloud-api.yandex.net/v1/disk/resources?path=disk%3A%2FMusic",
  "method": "GET",
  "templated": false
}

Описание элементов ответа

Элемент	Описание
`href`	URL. Может быть шаблонизирован, см. ключ `templated`.
`method`	HTTP-метод для запроса URL из ключа `href`.
`templated`	Признак URL, который был шаблонизирован согласно RFC 6570. Возможные значения: «true» — URL шаблонизирован: прежде чем отправлять запрос на этот адрес, следует указать нужные значения параметров вместо значений в фигурных скобках. «false» — URL может быть запрошен без изменений.

Ответ с ошибкой

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

Некоторые возможные ошибки:

400 — Некорректные данные.
401 — Не авторизован.
403 — API недоступно. Ваши файлы занимают больше места, чем у вас есть. Удалите лишнее или увеличьте объём Диска. / Достигнут предел вложенности папок. / Пользователь не имеет прав доступа к общему диску.
404 — Не удалось найти диск указанного пользователя.
406 — Ресурс не может быть представлен в запрошенном формате.
409 — По указанному пути уже существует папка с таким именем. / Указанного пути не существует.
413 — Загрузка файла недоступна. Файл слишком большой.
423 — Технические работы. Сейчас можно только просматривать и скачивать файлы.
429 — Слишком много запросов.
503 — Сервис временно недоступен.
507 — Недостаточно свободного места.