Переименовывает файл.
Эта операция работает следующим образом:
- Хост WOPI проверяет, заблокирован ли файл в данный момент или нет.
- Если файл в данный момент заблокирован и значение X-WOPI-Lock не соответствует текущей блокировке файла, хост должен вернуть 409 Conflict («несоответствие блокировки«) и включить заголовок ответа X-WOPI-Lock, содержащий значение текущей блокировки файла.
- Если файл разблокирован, хост должен ответить 200 OK и продолжить переименование.
- Если хост не может переименовать файл, поскольку запрошенное имя недопустимо или противоречит существующему файлу, хост должен попытаться сгенерировать другое имя на основе запрошенного имени, которое соответствует требованиям к имени файла.
- Если хост не может сгенерировать другое имя, он должен вернуть 400 Bad Request. Ответ должен содержать заголовок X-WOPI-InvalidFileNameError, который описывает, почему имя файла было недействительным.
| Название | Описание | Тип |
| file_id | Идентификатор файла, который должен быть безопасным для URL. | строковый |
| Название | Описание | Тип |
| access_token | Маркер доступа, который хост будет использовать для определения того, авторизован ли запрос | строковый |
| Название | Описание | Тип | Наличие |
| X-WOPI-Override | Запрошенная операция с сервера WOPI (RENAME_FILE). | строковый | обязательно |
| X-WOPI-Lock | Идентификатор блокировки, который хост должен использовать для идентификации блокировки файла. | строковый | необязательно |
| X-WOPI-RequestedName | Имя файла без расширения файла (в формате UTF-7). | строковый | необязательно |
| Название | Описание | Тип | Наличие |
| X-WOPI-InvalidFileNameError | Причина, по которой операция переименования не может быть завершена. Этот заголовок следует включать только в том случае, если код ответа — 400 Bad Request. Это значение должно использоваться только для регистрационных целей. | строковый | необязательно |
| X-WOPI-Lock | Идентификатор блокировки, идентифицирующий текущую блокировку файла. Этот заголовок всегда должен быть включен при ответе на запрос с 409 Conflict. Его не следует включать при ответе на запрос 200 ОК. | строковый | необязательно |
| X-WOPI-LockFailureReason | Причина неудачной блокировки. Этот заголовок может быть включен при ответе на запрос с 409 Conflict. Он должен использоваться только для регистрационных целей. | строковый | необязательно |
