raff_volume

_{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.

Example — minimal

resource "raff_volume" "data" {
  name        = "data-01"
  size        = 100
  volume_type = "nvme"
  region      = "us-east"
}

Example — attached to a VM

resource "raff_volume" "data" {
  name            = "data-01"
  size            = 250
  volume_type     = "nvme"
  region          = "us-east"
  filesystem_type = "ext4"        # only used on first attach
  vm_id           = raff_vm.api.id
}

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

terraform import raff_volume.data <volume-id>

Permissions

The API key needs volume.create, volume.manage, and volume.delete in the project. The system role Project Admin grants all of these.

Data sources

# Single volume by ID
data "raff_volume" "data" {
  id = 42
}

# All volumes in the current project
data "raff_volumes" "all" {}

output "volume_count" {
  value = length(data.raff_volumes.all.volumes)
}

raff_vm

Compute resource volumes attach to.

raff_snapshot

Point-in-time volume snapshots.

CLI: raff volume

Imperative equivalent.

Getting Started

Guides

REST API

CLI

Terraform

raff_volume

Example — minimal

Example — attached to a VM

Argument reference

Required

Optional

Attribute reference (computed)

Lifecycle

Importing existing volumes

Permissions

Data sources

raff_vm

raff_snapshot

CLI: raff volume

​Example — minimal

​Example — attached to a VM

​Argument reference

​Required

​Optional

​Attribute reference (computed)

​Lifecycle

​Importing existing volumes

​Permissions

​Data sources

​Related

raff_vm

raff_snapshot

CLI: raff volume

Example — minimal

Example — attached to a VM

Argument reference

Required

Optional

Attribute reference (computed)

Lifecycle

Importing existing volumes

Permissions

Data sources

Related