Создание папки
Создавать папки на Диске можно, указывая требуемый путь к новой папке.
Формат запроса
Запрос создания папки следует отправлять с помощью метода PUT.
https://cloud-api.yandex.net/v1/disk/resources
? path=<путь к создаваемой папке>
& [fields=<свойства, которые нужно включить в ответ>]
- path*
-
Путь к создаваемой папке. Например, чтобы создать папку
Music
в корневом каталоге Диска, следует задать значение параметра%2FMusic
. Максимальная длина имени создаваемой папки — 255 символов; максимальная длина пути — 32760 символов.Путь в значении параметра следует кодировать в URL-формате.
- fields
-
Список свойств JSON, которые следует включить в ответ. Ключи, не указанные в этом списке, будут отброшены при составлении ответа. Если параметр не указан, ответ возвращается полностью, без сокращений.
Имена ключей следует указывать через запятую, а вложенные ключи разделять точками. Например:name,_embedded.items.path
.
* Обязательный параметр.
Формат ответа
Если запрос был обработан без ошибок, API отвечает кодом 201 Created
(папка успешно создана). В теле ответа, в объекте Link, возвращается ссылка на мета-информацию о созданном ресурсе.
Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит описание ошибки.
Пример ответа:
{
"href": "https://cloud-api.yandex.net/v1/disk/resources?path=disk%3A%2FMusic",
"method": "GET",
"templated": false
}
Элемент |
Описание |
|
URL. Может быть шаблонизирован, см. ключ |
|
HTTP-метод для запроса URL из ключа |
|
Признак URL, который был шаблонизирован согласно RFC 6570. Возможные значения:
|
Путь к создаваемой папке. Например, чтобы создать папку Music
в корневом каталоге Диска, следует задать значение параметра %2FMusic
. Максимальная длина имени создаваемой папки — 255 символов; максимальная длина пути — 32760 символов.
Путь в значении параметра следует кодировать в URL-формате.
Список свойств JSON, которые следует включить в ответ. Ключи, не указанные в этом списке, будут отброшены при составлении ответа. Если параметр не указан, ответ возвращается полностью, без сокращений.
Имена ключей следует указывать через запятую, а вложенные ключи разделять точками. Например: name,_embedded.items.path
.
Обязательный параметр.