5.7 KiB
Проверка 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 остаётся открытой. Сценарий восстановления.