--- title: 'API - Взаимодействие с Backup | Zomro' description: 'В этой инструкции описано, как можно создавать, просматривать имеющиеся, и удалять резервные копии с помощью API' image: 'https://dx86q6oq7ry0e.cloudfront.net/uploads/blog/a54%40server-panel.net/2024/07/23/screenshot-from-2024-07-23-15-31-16_q50.jpg' --- ![opened image]() * [Zomro](https://zomro.com/rus/) * [Полезные статьи](https://zomro.com/rus/blog/articles/) * API - Взаимодействие с Backup # API - Взаимодействие с Backup 23-07-2024 В этом документе описан процесс создания, просмотра и удаления резервных копий для instance с помощью API сервиса Zomro. Приведенные примеры запросов помогут вам быстро разобраться с основными операциями, необходимыми для управления резервными копиями через API. ## **Создание резервной копии** Чтобы создать резервную копию, выполните следующий запрос: URL: https://api.zomro.com/ Метод: POST Тело запроса(Form-data): Параметр | Пример значения | Обязательный параметр | Описание значения ---|---|---|--- func | instances.fleio_bckps.edit | Да | Функция, для создания резервной копии auth | 21fc199...c43f71 | Нет | Токен сессии. Это один из вариантов авторизации. Подробнее, какие еще есть варианты, описаны [здесь](https://ispsystem.com/docs/b6c/developer-section/working-with-api/guide-to-ispsystem-software-api) out | json | Да | Тип ответа, который ожидать sok | ok | Да | Подтверждение операции plid | 5203773 | Да | ID instance, для которой создать резервную копию name | MyBackup | Да | Название резервной копии Пример создания резервной копии для услуги Для примера, используем услугу: ![API - Взаимодействие с Backup - 1](https://dx86q6oq7ry0e.cloudfront.net/uploads/blog/a54%40server-panel.net/2024/07/23/screenshot-from-2024-07-23-15-31-16_q50.jpg) URL: https://api.zomro.com/ Метод: POST Тело запроса(Form-data): Параметр | Значение ---|--- func | instances.fleio_bckps.edit auth | 21fc199...c43f71 out | json sok | ok plid | 5203773 name | MyBackup Вот пример запроса, который можно выполнить из консоли: curl --location 'https://api.zomro.com/' \ --form 'func="instances.fleio_bckps.edit"' \ --form 'auth="d3ec30e337e01078a1d185cc"' \ --form 'out="json"' \ --form 'sok="ok"' \ --form 'plid="5203773"' \ --form 'name="MyBackup"' После выполнения запроса, видим, что резервная копия в процессе создания. Как видим backup имеет значение Saving: ![API - Взаимодействие с Backup - 2](https://dx86q6oq7ry0e.cloudfront.net/uploads/blog/a54%40server-panel.net/2024/07/23/screenshot-from-2024-07-23-15-33-09_q50.jpg)​​​​​​​ После завершения создания резервной копии, статус резервной копии изменится с Saving на Active: ![API - Взаимодействие с Backup - 3](https://dx86q6oq7ry0e.cloudfront.net/uploads/blog/a54%40server-panel.net/2024/07/23/screenshot-from-2024-07-23-15-37-40_q50.jpg) Как видим, статус услуги является Active. ## **Как получить список резервных копий с помощью API** ## Также, с помощью API есть возможность получить список резервных копий. Для этого выполняем следующий формат запроса: URL: https://api.zomro.com/ Метод: POST Тело запроса(Form-data): Параметр | Пример значения | Обязательный параметр | Описание значения ---|---|---|--- func | instances.fleio_bckps | Да | Функция, для получения всех резервных копий auth | 21fc199...c43f71 | Нет | Токен сессии. Это один из вариантов авторизации. Подробнее, какие еще есть варианты, описаны [здесь](https://ispsystem.com/docs/b6c/developer-section/working-with-api/guide-to-ispsystem-software-api) out | json | Да | Тип ответа, который ожидать plid | 5203773 | Да | ID instance, резервные копии которой планируется получить Для примера, попробуем получить резервные копии для услуги 5203773. На предыдущем шаге, создали 1 резервную копию. Попробуем получить ее. Попробуем выполнить следующий запрос в консоли: curl --location 'https://api.zomro.com/' \ --form 'func="instances.fleio_bckps"' \ --form 'auth="8409b4eea786e3cad35eacf7"' \ --form 'out="json"' \ --form 'elid="5203773"' Получаем следующий результат: { "doc": { ... "elem": [ { "architecture": { "$": "x86_64" }, "backup_type": { "$": "manual" }, "createdate": { "$": "2024-07-23" }, "disk_format": { "$": "qcow2" }, "fleio_id": { "$": "b26c0f34-48b2-4cb2-b4eb-388eac959df6" }, "fleio_status": { "$": "Active" }, "hypervisor_type": { "$": "any_hypervisor" }, "id": { "$": "5203980" }, "image_size": { "$": "3" }, "item_real_status": { "$": "2" }, "min_disk": { "$": "20" }, "min_ram": { "$": "0" }, "name": { "$": "MyBackup" }, "os_distro": { "$": "Ubuntu" }, "os_version": { "$": "22.04 x64" }, "protected": { "$": "off" }, "region": { "$": "Netherlands-2" }, "visibility": { "$": "private" } } ], } } Нас интересует данные, которые получены в следующие вложенности:​​​​​​​ doc.elem.[] Из этого ответа, мы получаем следующие данные: Название поля | Описание ---|--- architecture | Архитектура виртуальной машины backup_type | Каким образом была создана резервная копия: Вручную или по расписанию createdate | Время создания резервной копии disk_format | Тип файла резервной копии fleio_id | Уникальный UUID в системе fleio fleio_status | Статус резервной копии. Значение Active означает, что резервная копия создана hypervisor_type | Тип гипервизора для виртуальной машины id | ID резервной копии в пределах bill manager image_size | Фактический размер резервной копии. Определяется после завершения создания резервной копии item_real_status | Статус услуги в рамках billmanager min_disk | Минимальный размер диска на сервере который нужен, чтобы восстановить данную резервную копию min_ram | Минимальный размер ОЗУ на сервере, который нужен, чтобы восстановить данную резервную копию name | Название резервной копии os_distro | Название операционной системы os_version | Версия операционной системы protected | Сообщает, разрешено ли удалять резервную копию. При значении «off», резервную копию возможно удалить. В случае «on» - резервную копию невозможно удалить. region | Название датацентра, где находится резервная копия visibility | Статус доступа к резервной копии. Единственное доступное значение является «Private» ## **Как удалить резервную копию** **​​​​​​​** Для удаления резервной копии выполняем следующий запрос: URL: https://api.zomro.com/ Метод: POST Тело запроса(Form-data): Параметр | Пример значения | Обязательный параметр | Описание значения ---|---|---|--- func | image.delete | Да | Функция, удаление резервной копии auth | 21fc199...c43f71 | Нет | Токен сессии. Это один из вариантов авторизации. Подробнее, какие еще есть варианты, описаны [здесь](https://ispsystem.com/docs/b6c/developer-section/working-with-api/guide-to-ispsystem-software-api) out | json | Да | Тип ответа, который ожидать plid | 5203773 | Да | ID instance, резервные копии которой планируется получить elname | 5203980 | Да | ID резервной копии, которую нужно удалить elid | 5203980 | Да | ID резервной копии, которую нужно удалить sok | ok | Да | Подтверждение выполнения операции Попробуем выполнить следующий запрос в консоли: curl --location 'https://api.zomro.com/' \ --form 'func="image.delete"' \ --form 'auth="72307c8cfc94e631d835438f"' \ --form 'out="json"' \ --form 'sok="ok"' \ --form 'plid="5203773"' \ --form 'elname="5203980"' \ --form 'elid="5203980"' После выполнения запроса, проверить результат можно с помощью функции «instances.fleio_bckps», или просмотрев с помощью веб интерфейса: ![API - Взаимодействие с Backup - 4](https://dx86q6oq7ry0e.cloudfront.net/uploads/blog/a54%40server-panel.net/2024/07/23/screenshot-from-2024-07-23-15-38-37_q50.jpg)​​​​​​​ Как можем увидеть, резервная копия была успешно удалена. Также предлагаем изучить статьи, которые могут быть полезными для взаимодействия с продуктами [Cloud VPS ](https://zomro.com/rus/vps)с помощью API: * [_API - Создание услуги_](https://zomro.com/rus/blog/articles/462-api-creation-of-a-service) * [_API - Получение информации о доступных тарифах и их параметрах_](https://zomro.com/rus/blog/articles/464-api-obtaining-information-about-available-tariffs-and-their-parameters) * [_API - Операция Start & Stop_](https://zomro.com/rus/blog/articles/468-api-operation-start-and-stop) * [_API - Операция Reboot_](https://zomro.com/rus/blog/articles/465-api-operation-reboot) * [_API - Операция Rebuild_](https://zomro.com/rus/blog/articles/466-api-operation-rebuild) * [_API - Операция Delete_](https://zomro.com/rus/blog/articles/467-api-operation-delete) * [_API - Взаимодействие с Image_](https://zomro.com/rus/blog/faq/487-api-interaction-with-image) * [_API - Взаимодействие с Backup Schedule_](https://zomro.com/rus/blog/faq/486-api-interaction-with-backup-schedule) * [_API - Взаимодействие с Rescue_](https://zomro.com/rus/blog/faq/485-api-interacting-with-rescue)​​​​​​​ * [_API - Взаимодействие с Snapshots_](https://zomro.com/rus/blog/faq/483-api-interacting-with-snapshots) * [_API - Взаимодействие с Boot From ISO_](https://zomro.com/rus/blog/faq/484-api-interacting-with-boot-from-iso) Похожие статьи [Создаем надежный и безопасный пароль](https://zomro.com/rus/blog/articles/27-sozdaem-nadezhnyy-i-bezopasnyy-parol) [Оптимизация производительности сайта на сервере VPS](https://zomro.com/rus/blog/articles/536-optimizing-website-performance-on-a-vps-server) [Определяем целевой рынок для бизнеса](https://zomro.com/rus/blog/articles/88-opredelyaem-celevoy-rynok-dlya-biznesa) [Онлайн бизнес: Как выбрать хостинг для успешного размещения сайта](https://zomro.com/rus/blog/articles/424-kak-vybrat-onlajn-hosting-dlya-biznesa) [Читабельность контента](https://zomro.com/rus/blog/articles/40-chitabelnost-kontenta) [ Premium Cloud VPS от €7.95/мес ](/rus/vps)