Updated May 10, 2026 Manages a Raff block storage volume — NVMe SSD, sized in GB, region-pinned, attached to one VM at a time. Volumes can be created standalone and attached later, or attached at create time.Documentation Index
Fetch the complete documentation index at: https://docs.rafftechnologies.com/llms.txt
Use this file to discover all available pages before exploring further.
Example — minimal
Example — attached to a VM
Argument reference
Required
| Argument | Type | Description |
|---|---|---|
name | string | Volume display name. Updates rename in place |
size | int | Size in GB. Updates trigger an in-place resize (must be larger than current — volumes cannot shrink) |
volume_type | string | Storage class. Currently nvme |
Optional
| Argument | Type | Description |
|---|---|---|
region | string | Region. Defaults to the project’s default region. ForceNew |
filesystem_type | string | Filesystem laid down on first attach (Linux only) — ext4, xfs, or btrfs. Defaults to ext4. ForceNew |
vm_id | string (UUID) | VM to attach the volume to. Updating triggers detach-then-reattach (volume and VM must be in the same region) |
Attribute reference (computed)
| Attribute | Description |
|---|---|
id | Volume ID |
status | Lifecycle state |
price_per_hour | Hourly price in USD |
account_id | Owning account UUID |
project_id | Owning project UUID |
created_at / updated_at | RFC3339 timestamps |
Lifecycle
| Operation | Behavior |
|---|---|
terraform apply (create) | Creates volume, optionally attaches to vm_id |
Change name | In-place rename |
Change size | In-place resize — must grow, never shrink |
Change vm_id | In-place detach (from old) then attach (to new) |
Change region, volume_type, filesystem_type | Replacement — destroy + recreate |
terraform destroy | Deletes the volume. Detach the VM first if still attached |
Importing existing volumes
Permissions
The API key needsvolume.create, volume.manage, and volume.delete in the project. The system role Project Admin grants all of these.
Data sources
Related
raff_vm
Compute resource volumes attach to.
raff_snapshot
Point-in-time volume snapshots.
CLI: raff volume
Imperative equivalent.