Skip to main content

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.

Updated May 10, 2026 Reserves a Raff floating IP — a public IP that’s held by the project and can be attached/detached/swapped between VMs. The IP is reserved until the resource is destroyed. To attach a reserved IP to a VM, use raff vm ip attach (the public API supports attach/detach but not via a Terraform attachment resource yet).

​
Example — minimal

resource "raff_ip" "web" {}
That’s enough — defaults to IPv4 in the project’s default region.

​
Example — explicit

resource "raff_ip" "web" {
  type           = "ipv4"
  region         = "us-east"
  billing_period = "monthly"
}

​
Argument reference

All arguments are optional. All are ForceNew — change one and Terraform releases the old IP and reserves a new one (which will be a different IP address).
ArgumentTypeDescription
typestringIP family — ipv4 (default) or ipv6
regionstringRegion. Defaults to the project’s default region
billing_periodstringSubscription billing period. Ignored for PAYG accounts

​
Attribute reference (computed)

AttributeDescription
idFloating IP UUID
ip_addressThe reserved IP address
statusfree (not attached) or in-use (attached to a VM)
reservedtrue while held by the project
account_id / project_idOwning account / project UUIDs
created_at / updated_atRFC3339 timestamps

​
Lifecycle

OperationBehavior
terraform apply (create)Reserves a new IP from the regional pool
Change any inputReplacement — release + reserve (the IP address changes)
terraform destroyReleases the IP back to the regional pool

​
Importing existing IPs

terraform import raff_ip.web <ip-uuid>

​
Permissions

The API key needs ip.reserve, ip.manage, and ip.release in the project. The system role Project Admin grants all of these.

​
Data sources

# Single floating IP by UUID
data "raff_ip" "web" {
  id = raff_ip.web.id
}

# All floating IPs in the current project
data "raff_ips" "all" {
  type   = "ipv4"
  status = "free"
}

raff_vm

Compute the IP can be attached to.

CLI: raff ip

Imperative equivalent (incl. attach/detach/swap).

CLI: raff vm ip attach

Attach a reserved IP to a VM.
Last modified on May 11, 2026