Перемещение и переименование файла

Содержание

Обзор
Запросы
- Перемещение файла
См. также

Обзор

Перемещает или переименовывает файл в пределах одного раздела, не передавая его содержимое. Операция выполняется средствами файловой системы, поэтому её стоимость не зависит от размера файла.

Отдельного метода для этого нет: используется PUT по пути назначения с заголовком X-Era-Source и пустым телом. Наличие заголовка и отличает перемещение от заливки.

Перемещение каталогов не поддерживается.

Запросы

HTTP verb Endpoint Описание

HTTP verb	Endpoint	Описание
`PUT`	`/rest/v1/fs/targets/<target>/<path>`	Перемещение файла

PUT

/rest/v1/fs/targets/<target>/<path>

Перемещение файла

Особенности

Значение заголовка X-Era-Source — путь источника относительно корня раздела, а не полный URL. Выход за пределы раздела и сегменты .. отвергаются с кодом 403.
Источник и назначение принадлежат одному разделу. Перенести файл между разделами одним запросом нельзя.
Недостающие каталоги пути назначения создаются, опустевшие каталоги источника удаляются.
Путь назначения создаётся только после проверки источника: неудачное перемещение не оставляет за собой пустых каталогов.
Запрос не должен одновременно содержать тело и заголовок X-Era-Source: такой запрос неоднозначен и отвергается с кодом 400.

Запрос

Table 1. Параметры запроса
Имя	Тип	Описание
`overwrite`	`bool`	Разрешить перезапись занятого пути назначения. По умолчанию `false`.

Table 2. Заголовки запроса
Имя	Описание
`X-Era-Source`	Путь исходного файла относительно корня раздела.

Пример переименования

PUT /rest/v1/fs/targets/files/inbox/report-2026.pdf HTTP/1.1
X-Era-Source: inbox/report.pdf
Content-Length: 0

Пример перемещения в другой каталог с перезаписью

PUT /rest/v1/fs/targets/files/archive/2026/report.pdf?overwrite=true HTTP/1.1
X-Era-Source: inbox/report.pdf
Content-Length: 0

Ответ

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

HTTP/1.1 204 No Content

Код Условие

Код	Условие
`204`	Файл перемещён.
`400`	Запрос содержит и тело, и заголовок `X-Era-Source`.
`403`	Путь источника выходит за пределы раздела.
`404`	Исходного файла не существует.
`409`	Путь назначения занят, а параметр `overwrite` не указан; либо источник является каталогом.

204

Файл перемещён.

400

Запрос содержит и тело, и заголовок X-Era-Source.

403

Путь источника выходит за пределы раздела.

404

Исходного файла не существует.

409

Путь назначения занят, а параметр overwrite не указан; либо источник является каталогом.