Методы управления ВМ
Когда применять
Для программных операций с виртуальными машинами: создание, запуск, миграция, снимки.
Методы
Группа методов управления жизненным циклом ВМ. Каждый метод требует привилегии с областью действия на нужный ВЦОД.
vm-migration
Переносит данные остановленной виртуальной машины в другой пул хранения: полный цикл ZFS send/receive, затем перерегистрация дисков, снимков и самой машины, затем удаление исходного датасета. Метод асинхронный — ответ приходит после завершения всего цикла, а не после старта копирования.
Доступен только роли Cluster master. Машина должна быть остановлена или
создана и ещё не запускалась; миграция на исходный пул запрещена.
| Параметр | Тип | Обязателен | Описание |
|---|---|---|---|
vm_id | i32 | да | ID виртуальной машины |
migration_pool | string | да | имя целевого пула, формат z и две цифры — например z02 |
Коды отказа: -25300 — метод вызвала не роль Cluster master; -25304 — не
удалось определить узел машины; -25305 — целевой пул совпадает с исходным;
-25306 — машина не остановлена и не в состоянии «создана»; -25307 — не
удалось определить узел целевого пула; -25308 — нет свободных портов передачи;
-25310 — цикл не завершился, сбой перерегистрации.
Пример
{"jsonrpc": "2.0", "method": "vm-migration", "params": {"vm_id": 42, "migration_pool": "z02"}, "id": 1}
См. также
- Как выбрать между сменой узла и сменой пула — «Перенос ВМ: смена узла и смена пула».