Files
MikrotikManager/docs/mcp-backups-call-audit-20261114.md
T

5.7 KiB
Raw Blame History

Проверка 12 MCP-вызовов резервного копирования

Вызов Контракт и проверка
mm_backups_list Записи БД по серверу с пагинацией.
mm_backup_job_get Чтение фоновой задачи приложения и её доступных частей.
mm_backup_download_plan План выдачи владельцу артефакта копии из локального хранилища или S3. Проверяются принадлежность, подтверждение и срок выдачи.
mm_backups_create_plan При применении получает текстовый экспорт RouterOS. GET /rest/file фиксирует исходный список, POST /rest/export передаёт имя временного файла, POST /rest/file/read читает его порциями до 32768 байт, завершающий DELETE удаляет временный файл по подтверждённому ID. Приложение сохраняет .rsc локально или в S3.
mm_backups_restore_plan После подтверждения читает сохранённый .rsc, проверяет допустимость и загружает его на RouterOS. Загрузка пробует PUT /rest/file с name/contents, затем POST /rest/file/add с type=file. Применяет POST /rest/import с file-name. При 404/405 используется POST /rest/execute с фиксированной командой импорта. Результат импорта требует отдельной сверки состояния.
mm_backups_delete_plan Удаление сохранённой копии приложения и её записи.
mm_backup_schedule_get Чтение расписания приложения.
mm_backup_schedule_update_plan Сохранение расписания с обновлением планировщика после применения.
mm_backup_storage_get Чтение настроек локального/S3-хранилища приложения.
mm_backup_storage_update_plan Запись настроек с проверкой снимка конфигурации, отдельной ссылкой на секрет и подтверждением области.
mm_backup_storage_test_plan Проверка подключения к S3 после одобрения.
mm_backup_storage_sync_plan Чтение списка объектов S3 и импорт отсутствующих записей в БД.

Контракт экспорта и порционного чтения подтверждён руководством MikroTik. Текстовый .rsc сохраняет экспортируемую конфигурацию. Руководство перечисляет исключения, включая пароли системных пользователей, установленные сертификаты и SSH-ключи. Импорт выполняет команды файла и не доказывает полного восстановления связности по одной квитанции. Поддержку обеих REST-форм загрузки и запасного /execute нужно проверять отдельно для версии устройства. REST API · Configuration Management · Files

Исходная реализация допускала переход к другому пути или методу после потери подтверждения. В рабочей версии переход оставлен для явного HTTP 404/405. При потере ответа или неподтверждённом чтении загрузка останавливается до импорта. Для общего локального прогона добавлены случаи явного отказа метода, потери ответа и отсутствия файла при чтении. Загрузка и импорт · Экспорт и точное чтение · Сервис резервных копий · Регистрация MCP · Сценарии HTTP

REST и MCP используют общий сервис восстановления. Под блокировкой управляемого сервера он проверяет точный путь, native ID, размер и байты загруженного .rsc через порционное чтение перед импортом. Целевой локальный сценарий подтвердил один импорт при совпадении и ноль импортов при подмене байтов того же размера, совпадении только базового имени в другом каталоге или дубликате точного пути. Проверка поддерживаемого RouterOS и фактического результата импорта на CHR остаётся открытой. Сценарий восстановления.