Skip to main content

RebuildVmRequest

Request body for rebuilding a virtual machine (reinstalling it from a new image).

imageIdstring<uuid>

Id of the OS image to reinstall the VM with. Required; must not be an empty GUID.

sshKeyIdsstring<uuid>[]nullable

Ids of SSH keys to authorize on the rebuilt VM. At most 10 entries; must not contain empty GUIDs. If omitted or empty, the rebuilt VM has no SSH keys (the previously bound keys are NOT carried over); otherwise these keys become the effective set for the rebuilt VM.

deleteBackupsboolean

When true, all existing backups of this VM are deleted as part of the rebuild. Defaults to false (backups are kept). Useful when switching OS, because a backup taken under the previous OS cannot be meaningfully restored onto the new one.

RebuildVmRequest
{
"imageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"sshKeyIds": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"deleteBackups": true
}