Kvindo™ Cloud Docs
A Volume is a block storage device that provides persistent disk space for VMs. Volumes exist independently of VMs and can be attached, detached, and re-attached as needed. A volume seeded with an OS image can serve as a VM's boot disk.
• Size — storage capacity in GiB
• OS image — an optional OS image identifier (osImageId) used to seed the volume; a volume seeded this way can boot a VM
• Offer — the disk type/tier (offerId); see the console for the catalog
• Attachment — the VM a volume is currently connected to (see Volume Attachment)
A volume persists after a VM is deleted; it must be deleted explicitly.
| UI Name | API / kc name | Terraform name | Optional | Format | Default | Is read only | Description |
|---|---|---|---|---|---|---|---|
| Hosting Provider | spec.hostingProviderId |
spec.hosting_provider_id |
No | ULID — references a Hosting Provider | — | No | Provider on which the volume is provisioned; run kc get provider for the options |
| OS Image | spec.osImageId |
spec.os_image_id |
Yes | string (nullable) | — | No | OS image identifier used to seed the volume (e.g. 200 = Ubuntu Server 24.04 LTS); see Console → Compute → Images. Omit for a blank data disk. Mutually exclusive with imageId |
| Offer | spec.offerId |
spec.offer_id |
No | string | — | No | Disk offer / type id — there is no server-side default, so pass one explicitly (gp3-750 is the cheapest); see Console → Volumes |
| Size (GiB) | spec.sizeGiB |
spec.size_gib |
No | integer | — | No | Volume capacity in GiB |
| Image | spec.imageId |
spec.image_id |
Yes | ULID (nullable) — references an Image | — | No | Restore the volume from an existing Image — the Image must have been captured from a Volume, not from a VM. Mutually exclusive with osImageId |
Terraform
Python SDK
kc CLI
Examples
More in this section