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

Создавать папки на Диске можно, указывая требуемый путь к новой папке.

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

Метод: PUT.

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

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

path*

Путь к создаваемой папке. Например, чтобы создать папку Music в корневом каталоге Диска, следует задать значение параметра %2FMusic. Максимальная длина имени создаваемой папки — 255 символов; максимальная длина пути — 32760 символов.

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

fields

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

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

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

Заголовок

Authorization: OAuth <token>

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

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

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

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

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

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

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

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

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

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