Перейти к основному содержимому

Создать резервную копию

POST
/projects/:projectId/vms/:vmId/backups

Создаёт резервную копию указанной машины. Операция асинхронная.

Эндпоинт не принимает тело запроса: машина для резервного копирования определяется параметрами пути.

Хранение: у каждой машины хранится не больше фиксированного числа копий (сейчас 7). Если новая копия превысила бы этот предел, самая старая копия машины удаляется автоматически. Запрос из-за этого не завершается ошибкой — он лишь занимает немного больше времени, потому что старая копия удаляется до начала создания новой.

Ответ 202 означает только то, что запрос принят, а не то, что копия уже существует. Возвращаемый в CommandAccepted идентификатор commandId — внутренний, и запросить его через публичные эндпоинты нельзя. Чтобы дождаться завершения, опрашивайте GET /v1/projects/{projectId}/vms/{vmId} и следите за полем operationStatus: во время создания копии он равен InProgress, а operation — CreateBackup. Либо опрашивайте этот список копий и ждите появления новой записи: запись появляется только после успешного завершения, а при неудаче не создаётся вовсе.

Пока идёт резервное копирование, машина заблокирована: запуск, остановка, создание ещё одной копии и другие операции с этой же машиной завершаются с 409 Conflict, пока текущая операция не закончится.

Запрос​

Ответы​

Запрос на создание резервной копии принят в асинхронную обработку.