VM

Create virtual machine storage from a disk image

Copy or convert a completed Downloader disk image into a writable managed RAW file or ZFS volume and attach it to a shut-off virtual machine. The source download remains unchanged. Omit size to use the image's virtual capacity, or specify a larger size in bytes; guest partitions and filesystems are not expanded automatically. Installer ISOs and images with external backing files are rejected. Compressed images must be extracted first. Storage topology changes are blocked while the VM is protected by replication.

post/vm/{rid}/storage/from-image

Path parameters

ridinteger required

Virtual Machine RID

Request body

bootOrderinteger
downloadUUIDstring required
emulation'virtio-blk' | 'virtio-9p' | 'ahci-hd' | 'ahci-cd' | 'nvme' required
namestring required
poolstring required
recordSizeinteger
sizeinteger
storageType'raw' | 'zvol' | 'image' | 'filesystem' | 'none' required
volBlockSizeinteger

Response

Created

errorstring
messagestring
statusstring

Changes