Бекапы

Получение настроек бекапов

GET /backup/settings

Ответ на успешный запрос:

{
   "common": {
      "hour": int,
      "rotate": "weekly | monthly"
   },
   "ftp": {
      "enabled": boolean,
      "server": "string",
      "login": "string",
      "password": "string",
      "remote_dir": "string"
   },
   "cifs": {
      "enabled": boolean,
      "server": "string",
      "login": "string",
      "password": "string",
      "remote_dir": "string"
   }
}

• common - общие настройки бекапов;

  • hour - час, в который делается автоматический бекап, число от 0 до 23;

  • rotate - удалять бекапы старше недели (weekly) или месяца (monthly);

• ftp - настройки выгрузки бекапов на FTP:

  • enabled - выгрузка включена/выключена;

  • server - адрес сервера, валидный домен или IP-адрес;

  • login - логин, не пустая строка;

  • password - пароль, не пустая строка, до 42 символов;

  • remote_dir - удаленный каталог, не пустая строка;

• cifs - настройки выгрузки бекапов в общую папку CIFS:

  • enabled - выгрузка включена/выключена;

  • server - адрес сервера, валидный домен или IP-адрес;

  • login - логин, не пустая строка;

  • password - пароль, не пустая строка, до 42 символов;

  • remote_dir - удаленный каталог, не пустая строка.

Изменение настроек бекапов и настройка выгрузки на FTP-сервер или в общую папку CIFS

PUT /backup/settings

Json-тело запроса:

{
   "common": {
      "hour": int,
      "rotate": "weekly | monthly"
   },
   "ftp": {
      "enabled": boolean,
      "server": "string",
      "login": "string",
      "password": "string",
      "remote_dir": "string"
   },
   "cifs": {
      "enabled": boolean,
      "server": "string",
      "login": "string",
      "password": "string",
      "remote_dir": "string"
   }
}

Ответ: 200 ОК

Управление бекапами

Создание бекапа

POST /backup/backups

Json-тело запроса:

{
   "comment": "string" (комментарий, произвольный текст)
}

Ответ на успешный запрос:

{
    "id": "string"
}

Получение списка бекапов

GET /backup/backups

Ответ на успешный запрос:

{
   "id": "string",
   "version": {
      "major": int,
      "minor": int,
      "build": int,
      "timestamp": int,
      "vendor": "Ideco",
      "product": "UTM" | "CC",
      "kind": "FSTEK" | "VPP" | "STANDARD" | "BPF",
      "release_type": "release" | "beta" | "devel"
   },
   "timestamp": "float",
   "comment": "string",
   "md5": "string",
   "size": "integer",
   "fast_restore_allowed": "boolean"
}

• id - идентификатор бекапа;

• version - версия системы:

  • major -мажорный номер версии;

  • minor - минорный номер версии;

  • build - номер сборки;

  • timestamp - время выхода версии;

  • vendor - вендор ("Ideco");

  • product - код продукта;

  • kind - вид продукта;

  • release_type - тип релиза;

• timestamp - дата/время создания бекапа в формате UNIX timestamp;

• comment - комментарий, произвольный текст;

• md5 - контрольная сумма файла бекапа (data.tar);

• size - размер бекапа, байт;

• fast_restore_allowed - можно ли выполнить быстрое восстановление из данного бекапа (версия идентична системной).

Скачивание бекапа

GET /backup/download/<id бекапа>

Ответ: тело бекапа.

Загрузка бекапа на Ideco NGFW из файла

POST /backup/upload

Используйте стандартный POST-запрос на загрузку файла. Название поля в форме должно быть backup_file.

Ответ на успешный запрос:

{
   "id": "string"
}

Восстановление из бекапа

POST /backup/backups/<id бекапа>/apply

Ответ: 200 ОК

Быстрое восстановление из бекапа

POST /backup/backups/<id бекапа>/apply/fast

Ответ: 200 ОК

Удаление бекапа

DELETE /backup/backups/<id бекапа>

Ответ: 200 ОК